mcp-server-spec-driven-development — Claude Code skill for specs
The mcp-server-spec-driven-development skill guides a project from EARS requirements to a design document and generated code. Use it when you want those steps to build on one another.
no license 175 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a claude-codeWhat mcp-server-spec-driven-development does
The skill lays out a three-stage process: write requirements in EARS format, derive a design document from them, then generate implementation code from the design. Requirements are organized into functional and non-functional groups, and design choices are mapped back to the requirements.
The stages use generate-requirements, generate-design-from-requirements, and generate-code-from-design. The first creates specs/requirements.md; the next produces specs/design.md; the final stage writes implementation files in the project root. The design stage needs the requirements file, and code generation needs the design document. Without those files, the later steps cannot proceed.
What it helps with
- write requirements in EARS format
- separate functional and non-functional requirements
- derive a design document from requirements
- generate implementation files from a design
- trace design decisions back to requirements
Example prompts for the agent
- Write my project requirements in EARS format and save them as
specs/requirements.md. - Turn
specs/requirements.mdinto an architecture and design document atspecs/design.md. - Generate implementation files in the project root based on
specs/design.md.
How to install mcp-server-spec-driven-development
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a claude-code2Manually: put the files in place
~/.claude/skills/mcp-server-spec-driven-development/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/mcp-server-spec-driven-development/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a codex2Manually: put the files in place
.agents/skills/mcp-server-spec-driven-development/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a cursor2Manually: put the files in place
.cursor/skills/mcp-server-spec-driven-development/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/mcp-server-spec-driven-development2Manually: put the files in place
.github/skills/mcp-server-spec-driven-development/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/mcp-server-spec-driven-developmentManually: put the files in place
.devin/skills/mcp-server-spec-driven-development/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -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 mcp-server-spec-driven-development
How do I install mcp-server-spec-driven-development in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill mcp-server-spec-driven-development -a claude-code. The skill file is placed at ~/.claude/skills/mcp-server-spec-driven-development/SKILL.md.
What does mcp-server-spec-driven-development do?
It guides development through EARS requirements, a design document, and code generation. Each stage uses the output of the previous one.
Which files does the skill need to generate design and code?
The design stage reads specs/requirements.md. Code generation then uses specs/design.md.