diff --git a/README.md b/README.md
new file mode 100644
index 0000000..5343dd8
--- /dev/null
+++ b/README.md
@@ -0,0 +1,34 @@
+# Jujutsu (jj) Skill
+
+A Claude Code skill that provides expert guidance for the jujutsu version control system. This skill gives Claude comprehensive knowledge of jj commands, concepts, and workflows.
+
+## Setup
+
+Copy this directory into your Claude Code skills folder:
+- Personal skills: `~/.claude/skills/`
+- Project skills: `<project>/.claude/skills/`
+
+See the [skills documentation](https://docs.claude.com/en/docs/claude-code/skills) for more details.
+
+## Usage
+
+Claude will automatically use this skill when you ask jujutsu-related questions. Once active, Claude can help with:
+
+- Explaining jj commands and concepts (working copy as a commit, change IDs, first-class conflicts)
+- Writing commands for specific workflows (rebasing, squashing, conflict resolution)
+- Using advanced features like revsets, filesets, and templates
+- Troubleshooting issues and recovering from mistakes
+
+## Examples
+
+```
+please rebase all of my current bookmarks onto main
+
+show me the differences between change x and change y
+
+split my current commit, putting all the test files in one commit and the implementation in another
+
+help me resolve the conflicts in my working copy
+
+squash the last 3 commits into one and update the commit message
+```