speckit-analyze

Analyze spec.md, plan.md, and tasks.md for cross-artifact consistency and coverage gaps.

Updated Jul 16, 2026
One-click install
npx skills add https://github.com/Argoss84/Kando-Caracter-sheet-generator --skill speckit-analyze-argoss84
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/Argoss84/Kando-Caracter-sheet-generator/tree/main/.cursor/skills/speckit-analyze
Command: npx skills add https://github.com/Argoss84/Kando-Caracter-sheet-generator --skill speckit-analyze-argoss84

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Specification-driven projects often drift out of sync: requirements in spec.md lack matching tasks, plan.md references entities the spec never defines, and ambiguous wording slips through until implementation. This Skill performs a read-only, cross-artifact consistency analysis across spec.md, plan.md, and tasks.md so teams catch inconsistencies, duplications, ambiguities, and coverage gaps before writing code. ## Core Features & Use Cases - Cross-Artifact Detection Passes: Detects duplications, ambiguities, underspecification, constitution violations, coverage gaps, and inconsistencies across the three core spec-kit artifacts. - Severity-Ranked Report: Produces a structured Markdown report with CRITICAL/HIGH/MEDIUM/LOW severity findings, a requirement-to-task coverage table, and metrics such as coverage percentage and ambiguity counts. - Constitution Enforcement: Validates artifacts against the non-negotiable project constitution in .specify/memory/constitution.md, flagging any MUST-principle conflict as CRITICAL. - Use Case: After running /speckit-tasks on a new feature, run this analysis to discover that a performance success criterion has no implementing task and that two requirements duplicate each other, then remediate before /speckit-implement. ## Quick Start Ask the assistant to run the speckit-analyze skill to check the current feature's spec.md, plan.md, and tasks.md for inconsistencies and coverage gaps.

Frequently Asked Questions about speckit-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check spec.md and tasks.md for consistency in spec-kit?▼

Run the speckit-analyze command after tasks.md has been generated. It loads spec.md, plan.md, and tasks.md, maps requirements to tasks, and outputs a severity-ranked report of inconsistencies, ambiguities, and coverage gaps without modifying any files.

When should I run spec analysis in a spec-driven workflow?▼

Run it after /speckit-tasks produces a complete tasks.md and before /speckit-implement. The analysis aborts with an error if tasks.md is missing, since it requires all three core artifacts to perform cross-artifact detection.

Does the analysis modify my spec or task files?▼

No, the analysis is strictly read-only. It outputs a structured Markdown report with findings and an optional remediation plan, but any edits must be explicitly approved and applied through separate commands like /speckit-specify or manual editing.

What happens if a requirement violates the project constitution?▼

Constitution conflicts are automatically classified as CRITICAL findings. The constitution in .specify/memory/constitution.md is treated as non-negotiable, so the spec, plan, or tasks must be adjusted rather than the principle being diluted or ignored.

What kinds of issues does cross-artifact analysis detect?▼

It detects near-duplicate requirements, vague terms lacking measurable criteria, unresolved placeholders, requirements with zero task coverage, unmapped tasks, terminology drift across files, conflicting requirements, and task ordering contradictions.