speckit-analyze

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

2|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/guestgraph/engine --skill speckit-analyze-guestgraph
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/guestgraph/engine/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/guestgraph/engine --skill speckit-analyze-guestgraph

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 to detect duplications, ambiguities, underspecified requirements, constitution violations, and coverage gaps before coding begins. ## Core Features & Use Cases - Consistency Detection: Identifies near-duplicate requirements, terminology drift, conflicting technical choices, and task ordering contradictions across the three core artifacts. - Coverage Mapping: Maps every functional requirement and success criterion to tasks, flagging requirements with zero coverage and unmapped tasks. - Constitution Validation: Checks artifacts against the project constitution's MUST principles, treating violations as CRITICAL findings. - Use Case: After running /speckit-tasks, invoke this Skill to receive a structured report with severity-ranked findings, a coverage summary table, and metrics before starting implementation. ## Quick Start Run the speckit-analyze skill to check my spec, plan, and tasks files for inconsistencies and missing requirement coverage.

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 consistency before implementation in spec-kit?▼

Run the speckit-analyze skill after /speckit-tasks completes. It loads spec.md, plan.md, and tasks.md, then reports duplications, ambiguities, coverage gaps, and constitution violations in a severity-ranked table without modifying any files.

What does the specification analysis report include?▼

The report contains a findings table with stable IDs, categories, and severities, a requirement-to-task coverage summary, constitution alignment issues, unmapped tasks, and metrics including total requirements, coverage percentage, and critical issue counts.

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

No, the analysis is strictly read-only. It outputs a structured report and optionally suggests remediation edits, but only applies changes after you explicitly approve and run follow-up commands manually.

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 or tasks.md is missing, directing you to the prerequisite command.

How are constitution violations handled during analysis?▼

Any requirement or plan element conflicting with a MUST principle in .specify/memory/constitution.md is automatically classified as CRITICAL. The constitution cannot be diluted or reinterpreted; changes to it require a separate explicit update.