speckit-analyze

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

Updated Aug 15, 2026
One-click install
npx skills add https://github.com/AhmedRagabRG/academy --skill speckit-analyze-ahmedragabrg
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/AhmedRagabRG/academy/tree/main/frontend/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/AhmedRagabRG/academy --skill speckit-analyze-ahmedragabrg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Inconsistent or incomplete specifications cause implementation failures. This Skill performs a read-only cross-artifact analysis across spec.md, plan.md, and tasks.md in a spec-kit project to detect duplications, ambiguities, underspecification, constitution violations, and coverage gaps before coding begins. ## Core Features & Use Cases - Cross-Artifact Consistency Checks: Detects terminology drift, conflicting requirements, and data entities referenced in one artifact but missing from others. - Coverage Mapping: Maps every functional requirement and success criterion to tasks, reporting requirements with zero task coverage and unmapped tasks. - Severity-Ranked Report: Produces a structured Markdown report with CRITICAL/HIGH/MEDIUM/LOW findings, metrics, and next-action recommendations. - Use Case: After running /speckit-tasks, run this analysis to verify that all requirements have task coverage and no constitution principles are violated before starting implementation. ## Quick Start Ask the agent to run a consistency analysis across the spec, plan, and tasks artifacts for the current feature 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 consistency between spec, plan, and tasks files?▼

Run the speckit-analyze command after tasks.md is generated. It loads spec.md, plan.md, and tasks.md, builds requirement and task inventories, and reports duplications, ambiguities, inconsistencies, and coverage gaps in a structured Markdown report.

How to find requirements with no task coverage in spec-kit?▼

The analysis maps each functional requirement and success criterion to tasks by keyword and ID references. The coverage summary table lists every requirement with its associated task IDs, flagging requirements that have zero tasks as gaps.

Does speckit-analyze modify my specification files?▼

No, the analysis is strictly read-only. It outputs a structured report and offers an optional remediation plan, but file edits only happen if you explicitly approve follow-up commands.

When should I run the analyze command in a spec-kit workflow?▼

Run it after /speckit-tasks has produced a complete tasks.md and before /speckit-implement. It aborts with an error if any required artifact 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 treated as non-negotiable within the analysis scope.