SDD Skills can be installed in three ways: directly into Claude Code through its plugin marketplace (the fastest path if you use Claude), across 45+ AI agents at once using SkillKit, or manually into any tool that supports custom slash commands or instruction files — including Cursor, Codex, and GitHub Copilot. All methods install the same 18 skills; the only difference is where the instruction files land on disk.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/jorgeferrando/sdd-skills/llms.txt
Use this file to discover all available pages before exploring further.
Install methods
- Claude Code
- SkillKit (Multi-Agent)
- Manual
From within an active Claude Code session, run these two commands in order:This fetches the skills directly from the repository using the Claude Code plugin system and makes all
/sdd-* commands available across every project. After both commands complete, restart Claude Code to load the new skills.One-liner install
If you want to install without cloning the repository first, use the curl one-liner. It downloads the installer and runs it automatically:Where skills are installed
Each tool stores skills in a different location. The installer handles this automatically, but here is the full mapping for reference:| Tool | Skills destination | Context file |
|---|---|---|
| Claude Code (global) | ~/.claude/skills/ | ~/.claude/CLAUDE.md |
| Claude Code (local) | .claude/skills/ | .claude/CLAUDE.md |
| Cursor | .cursor/rules/sdd/ | .cursor/rules/sdd.md |
| Codex | .sdd/skills/ | AGENTS.md |
| GitHub Copilot | .github/sdd/ | .github/copilot-instructions.md |
All available skills
All available skills (18 total)
All available skills (18 total)
Skills are listed in workflow order. You do not need to know this order to use SDD —
Change lifecycle
Shortcuts & utilities
/sdd-continue detects the correct next phase automatically.Setup & context| Skill | Purpose |
|---|---|
/sdd-init | Bootstrap a project — generates the openspec/ structure and 7 steering files |
/sdd-discover | Reverse-engineer canonical specs from an existing codebase |
/sdd-steer | Generate or sync steering files after conventions drift or a major refactor |
| Skill | Purpose |
|---|---|
/sdd-new | Start a new change — runs explore + propose in one command |
/sdd-explore | Read-only codebase exploration without creating a change |
/sdd-propose | Create proposal.md with problem, solution, alternatives, and impact |
/sdd-spec | Write a behavior spec (Given/When/Then delta spec) for the active change |
/sdd-design | Translate the spec into a concrete technical implementation plan |
/sdd-tasks | Break the design into ordered atomic tasks, one file and one commit each |
/sdd-apply | Implement the change task by task with atomic commits |
/sdd-verify | Run the full test suite, linters, self-review checklist, and create the PR |
/sdd-archive | Merge delta specs into canonical specs and close the change cycle |
| Skill | Purpose |
|---|---|
/sdd-ff | Fast-forward: generate proposal + spec + design + tasks in one pass |
/sdd-continue | Detect the next pending phase and execute it automatically |
/sdd-audit | Check code against conventions and project rules |
/sdd-docs | Generate a publishable MkDocs documentation site from openspec/ |
/sdd-recall | Search past specs and design decisions across archived changes |
/sdd-agent | Run a scoped SDD subagent for parallel or delegated tasks |
Requirements
- An AI coding assistant: Claude Code, Cursor, Codex, or GitHub Copilot
- Git
After installing, restart your editor to load the new skills. Once restarted, all
/sdd-* commands become available. Verify the installation by running /sdd-init — it should start the project bootstrap questionnaire without errors.