speckit-plan — Claude Code skill: what it does, how to install
Executes implementation planning workflows inside spec-kit projects to produce research notes and interface contracts.
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a claude-codeWhat speckit-plan does
This skill runs the implementation planning workflow for spec-kit projects. First, the agent checks .specify/extensions.yml for registered pre-hooks. Then it executes .specify/scripts/bash/setup-plan.sh --json to load spec paths and branch details.
Next, the agent reviews .specify/memory/constitution.md. In phase 0, it extracts technical unknowns and logs decisions into research.md. Phase 1 produces data-model.md and interface contracts in the contracts/ directory. Mandatory post-execution hooks run right before the final report.
The workflow depends on an existing .specify/ directory. Without spec-kit scripts in place, execution fails immediately.
What it helps with
- generate implementation plans from spec-kit templates
- resolve architectural unknowns and document trade-offs in research.md
- extract data models and interface contracts from feature specifications
- execute automated pre- and post-planning hooks defined in extensions.yml
Example prompts for the agent
- /speckit-plan
- /speckit-plan focus on backwards compatibility for existing endpoints
- /speckit-plan prioritize PostgreSQL schemas for the new entities
How to install speckit-plan
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a claude-code2Manually: put the files in place
~/.claude/skills/speckit-plan/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/speckit-plan/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a codex2Manually: put the files in place
.agents/skills/speckit-plan/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a cursor2Manually: put the files in place
.cursor/skills/speckit-plan/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills speckit-plan2Manually: put the files in place
.github/skills/speckit-plan/SKILL.md1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a gemini-cli2Platform CLI
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-planManually: put the files in place
.devin/skills/speckit-plan/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about speckit-plan
How to install speckit-plan in Claude Code?
Install it in your terminal by running npx skills add dceoy/speckit-agent-skills --skill speckit-plan -a claude-code.
What does speckit-plan do?
It guides an AI agent through generating architecture artifacts, resolving unknowns into research.md, and building entity models with interface contracts.
What are the project requirements for speckit-plan?
Your repository must follow the spec-kit structure, including a .specify/ directory with setup-plan.sh and .specify/memory/constitution.md.