speckit-analyze

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

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/dperussina/function2agent --skill speckit-analyze-dperussina
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/dperussina/function2agent/tree/main/.cursor/skills/speckit-analyze
Command: npx skills add https://github.com/dperussina/function2agent --skill speckit-analyze-dperussina

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Specification-driven projects accumulate drift between the spec, the implementation plan, and the task list, causing uncovered requirements, contradictions, and ambiguity that surface only during implementation. This Skill performs a read-only cross-artifact consistency and quality analysis before coding begins. ## Core Features & Use Cases - Cross-Artifact Detection Passes: Finds duplications, ambiguities, underspecified requirements, inconsistencies, and coverage gaps across spec.md, plan.md, and tasks.md. - Constitution Enforcement: Validates artifacts against the project constitution (.specify/memory/constitution.md), treating MUST-principle violations as CRITICAL findings. - Structured Report with Severity: Produces a findings table with stable IDs, severity levels (CRITICAL/HIGH/MEDIUM/LOW), a requirement-to-task coverage summary, and metrics, capped at 50 findings. - Use Case: After running /speckit-tasks, invoke this Skill to confirm every functional requirement has at least one task and no conflicting stack choices exist before running /speckit-implement. ## Quick Start Ask the agent to run the speckit-analyze skill to check the current feature's spec, plan, and tasks 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, plan, and tasks for inconsistencies in spec-kit?▼

Run the speckit-analyze skill after /speckit-tasks completes. It loads spec.md, plan.md, and tasks.md, runs detection passes for duplication, ambiguity, underspecification, and coverage gaps, then outputs a severity-ranked findings report.

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

Run it after task generation and before implementation. The skill requires a complete tasks.md produced by /speckit-tasks and aborts with an error if spec.md, plan.md, or tasks.md is missing.

Does the analysis 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 only applies changes after explicit user approval through separate editing commands.

What happens when a requirement violates the project constitution?▼

Constitution MUST-principle violations are automatically classified as CRITICAL findings. The report recommends adjusting the spec, plan, or tasks rather than diluting the principle, and constitution changes require a separate explicit update.

Why does the analysis report zero coverage for some requirements?▼

Zero coverage means a functional requirement or success criterion has no mapped task in tasks.md. The skill maps tasks to requirements by IDs and key phrases; add tasks covering the unmapped requirement or refine task descriptions to reference it.