speckit-analyze

Analyze spec.md, plan.md, and tasks.md for inconsistencies, gaps, and constitution violations.

Updated Sep 13, 2026
One-click install
npx skills add https://github.com/secrakib/rag-eval-project --skill speckit-analyze-secrakib
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/secrakib/rag-eval-project/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/secrakib/rag-eval-project --skill speckit-analyze-secrakib

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before implementation begins, specification artifacts often contain duplications, ambiguities, coverage gaps, and contradictions that cause costly rework. This Skill performs a read-only cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md so issues are caught early. ## Core Features & Use Cases - Cross-Artifact Detection Passes: Identifies duplications, ambiguities, underspecification, inconsistencies, and coverage gaps across the three core spec-kit artifacts. - Constitution Alignment Checks: Validates requirements and plans against the project constitution, flagging MUST-principle violations as CRITICAL findings. - Structured Analysis Report: Produces a severity-ranked findings table, requirement-to-task coverage summary, and metrics without modifying any files. - Use Case: After running /speckit-tasks, invoke this Skill to verify every functional requirement has task coverage and no conflicting technology choices exist before running /speckit-implement. ## Quick Start Ask the agent to run the speckit-analyze skill to check spec.md, plan.md, and tasks.md for inconsistencies and coverage gaps before implementation.

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-kit artifacts for inconsistencies before implementation?▼

Run the speckit-analyze skill after tasks.md is generated. It loads spec.md, plan.md, and tasks.md, runs detection passes for duplication, ambiguity, and coverage gaps, and outputs a severity-ranked findings report without modifying any files.

How to verify every requirement has task coverage in spec-kit?▼

The analysis builds a requirements inventory from FR and SC identifiers in spec.md and maps each task in tasks.md to requirements. The coverage summary table lists requirements with zero tasks and unmapped tasks, plus an overall coverage percentage.

Does speckit-analyze modify my spec or task files?▼

No, the analysis is strictly read-only. It outputs a structured Markdown report and optionally suggests remediation edits, but changes are only applied after explicit user approval through separate editing commands.

When should I run spec analysis in the spec-kit workflow?▼

Run it after /speckit-tasks has produced a complete tasks.md and before /speckit-implement. It aborts with an error if spec.md, plan.md, or tasks.md is missing, directing you to the prerequisite command.

What happens when a requirement violates the project constitution?▼

Constitution conflicts are automatically classified as CRITICAL findings. The report requires adjusting the spec, plan, or tasks to comply, since constitution principles are non-negotiable within the analysis scope.