spec-kit — Claude Code skill: what it does, how to install
Installs GitHub's specify CLI, bootstraps a spec-driven project for your agent, and runs the /speckit.* pipeline from constitution to implementation.
no license 167 installs ★ 61 updated 2026-11-19
npx skills add akillness/jeo-skills --skill spec-kit -a claude-codeWhat spec-kit does
Spec-driven development puts the spec first and lets it drive the code. This skill wraps GitHub's specify CLI for that job: it installs the tool, sets up a project for the agent you name, and walks the command pipeline. specify init writes .specify/, the command files your agent reads, and a constitution template.
The pipeline runs as slash commands inside the agent: /speckit.constitution for principles, /speckit.specify for requirements, /speckit.plan and /speckit.tasks for the plan and its breakdown, /speckit.implement to execute. Three optional commands help mid-flight — /speckit.clarify, /speckit.analyze, /speckit.checklist.
Pick the agent with --integration (claude, copilot, gemini, codex, cursor, opencode, qwen, kiro); specify integration list shows the rest. Python 3.11+ comes before anything else: on an older interpreter specify-cli will not install, so check the version first. uv or pipx handles the install, and git is needed for the repository.
What it helps with
- install
specify-cliwithout hand-editing paths - bootstrap a spec-driven project for one specific agent
- write project principles down before code exists
- turn requirements into a plan and a task list
- browse community extensions and presets
Example prompts for the agent
- Install spec-kit and bootstrap this repo for Codex:
specify init . --integration codex. - Run
/speckit.specifyon this feature, then/speckit.tasks. - Search community presets with
specify preset searchand add the one our team uses.
How to install spec-kit
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill spec-kit -a claude-code2Manually: put the files in place
~/.claude/skills/spec-kit/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/spec-kit/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill spec-kit -a codex2Manually: put the files in place
.agents/skills/spec-kit/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill spec-kit -a cursor2Manually: put the files in place
.cursor/skills/spec-kit/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install akillness/jeo-skills .agent-skills/spec-kit/SKILL.md2Manually: put the files in place
.github/skills/spec-kit/SKILL.md1Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill spec-kit -a gemini-cli2Platform CLI
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/spec-kitManually: put the files in place
.devin/skills/spec-kit/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add akillness/jeo-skills --skill spec-kit -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 spec-kit
How do I install spec-kit in Claude Code?
Run npx skills add akillness/jeo-skills --skill spec-kit -a claude-code. The skill lands at ~/.claude/skills/spec-kit/SKILL.md.
What does spec-kit do?
It installs specify-cli from GitHub's spec-kit and sets the project up for spec-driven development: .specify/, agent command files, a constitution template. The agent then runs the /speckit.* pipeline.
Which agents can I initialize a project for?
claude, copilot, gemini, codex, cursor, opencode, qwen, kiro and others that specify integration list reports. Choose one with --integration.