speckit-analyze — Claude Code skill: spec-kit artifact validation
speckit-analyze is a Claude Code skill that inspects consistency across spec.md, plan.md, and tasks.md. Runs strictly in read-only mode right before feature implementation starts.
AGPL-3.0 1,600 installs ★ 174 updated 2026-11-20
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a claude-codeWhat speckit-analyze does
speckit-analyze validates that specifications, technical plans, and generated tasks align without gaps or contradictory requirements. Prior to checking core files, it inspects .specify/extensions.yml for execution hooks and runs the prerequisite verification script. If data-model.md is present, the inspection also maps entity fields and constraint definitions to the planned tasks.
The routine never alters project files. It surfaces findings inside a structured report alongside an optional remediation plan. Any conflict with .specify/memory/constitution.md gets tagged as critical because project principles override individual tasks. Principles cannot be softened or skipped during this step.
Operation requires an initialized spec-kit directory layout under .specify/ and a completed tasks.md. Analysis stops immediately if any mandatory prerequisite file cannot be found.
What it helps with
- spec-kit artifact validation
- detect contradictions between requirements and task lists
- verify requirement coverage across implementation steps
- match data-model constraints against planned tasks
- catch violations of the project constitution
Example prompts for the agent
- Run speckit-analyze on the current feature branch
- Analyze consistency across spec, plan, and tasks
- Run /speckit-analyze focusing on user story coverage
How to install speckit-analyze
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a claude-code2Manually: put the files in place
~/.claude/skills/speckit-analyze/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/speckit-analyze/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a codex2Manually: put the files in place
.agents/skills/speckit-analyze/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a cursor2Manually: put the files in place
.cursor/skills/speckit-analyze/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills skills/speckit-analyze2Manually: put the files in place
.github/skills/speckit-analyze/SKILL.md1Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a gemini-cli2Platform CLI
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-analyzeManually: put the files in place
.devin/skills/speckit-analyze/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -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-analyze
How to install speckit-analyze in Claude Code?
Run npx skills add dceoy/speckit-agent-skills --skill speckit-analyze -a claude-code in your terminal.
What does speckit-analyze do?
It scans spec.md, plan.md, and tasks.md in read-only mode to surface ambiguities, duplications, and missing task coverage.
What is required to run speckit-analyze?
A repository organized with a .specify/ directory, the check-prerequisites.sh script, a constitution file, and a finished tasks.md.