diff --git a/README.md b/README.md
index d250c4c..5a56849 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
 # skills-software-development
 
-Skills for the Software Development process
+Reusable AI skills for software development workflows. These skills can be synced into any project to give AI coding assistants (Claude Code, Cursor, etc.) structured guidance for common development tasks.
+
+## Available Skills
+
+| Skill | Description |
+|---|---|
+| [code-review](code-review/) | Critical code review of uncommitted changes, checking for simplicity, dead code, scope creep, bugs, and completeness |
+| [code-self-review](code-self-review/) | Self-review after writing code — step back and critically evaluate your own work |
+| [code-cleanup](code-cleanup/) | Garbage collection for codebases — remove dead code, find duplication, reduce complexity, clean up stale comments |
+| [security-review](security-review/) | Security review from a pentester perspective — injection, auth, data exposure, input handling, misconfigurations |
+| [create-merge-request](create-merge-request/) | Create a GitLab Merge Request from uncommitted changes with proper branching and commit organization |
+| [understand-project](understand-project/) | Learn about a project from its docs, README, and structure before starting work |
+| [figma](figma/) | Fetch Figma design specs for pixel-perfect implementation (includes Node.js tool scripts) |
+
+## Structure
+
+Each skill is a directory containing:
+
+- `SKILL.md` — the skill definition (frontmatter + instructions)
+- `scripts/` — optional tool scripts used by the skill
+- `README.md` — optional setup instructions (e.g. API keys)