diff --git a/README.md b/README.md
new file mode 100644
index 0000000..308b521
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Claude Code User Configuration
+
+User-level Claude Code settings and skills.
+
+## Clone with Submodules
+
+```bash
+git clone --recurse-submodules https://git.prettyhefty.com/Bill/claude-code-user-config.git ~/.claude
+```
+
+## Initialize Submodules After Clone
+
+If you cloned without `--recurse-submodules`:
+
+```bash
+cd ~/.claude
+git submodule update --init --recursive
+```
+
+## Update Submodules
+
+Pull latest changes for all skills:
+
+```bash
+git submodule update --remote --merge
+```
+
+## Contents
+
+| Path | Description |
+|------|-------------|
+| `CLAUDE.md` | Global instructions for all projects |
+| `settings.json` | User permissions and plugin config |
+| `plugins/` | Plugin configuration |
+| `skills/` | User-level skills (as submodules) |