diff --git a/crates/cli/README.md b/crates/cli/README.md
index e69de29b..23c70fa7 100644
--- a/crates/cli/README.md
+++ b/crates/cli/README.md
@@ -0,0 +1,8 @@
+# CLI
+
+This is the crate that contains the aiken command line application
+which bundles together all the other crates in this project.
+
+## Install
+
+`cargo install aiken`
diff --git a/crates/uplc/README.md b/crates/uplc/README.md
index e69de29b..bb8b38a0 100644
--- a/crates/uplc/README.md
+++ b/crates/uplc/README.md
@@ -0,0 +1,4 @@
+# Untyped Plutus Core
+
+A crate for working with untyped plutus core. It handles
+parsing, conversion between various forms, and flat encoding/decoding.