speckit-analyze

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before implementation begins, inconsistencies between a feature's specification, technical plan, and task list can cause rework and missed requirements. This Skill performs a read-only, cross-artifact analysis to surface duplications, ambiguities, underspecified items, and coverage gaps before any code is written. ## 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, flagging requirements with zero task coverage and tasks with no mapped requirement. - Constitution Validation: Treats violations of project constitution MUST principles as CRITICAL findings that must be resolved before implementation. - Severity-Ranked Report: Produces a structured Markdown report with findings categorized by severity (CRITICAL, HIGH, MEDIUM, LOW), coverage metrics, and suggested next actions. - Use Case: After running /speckit-tasks to generate tasks.md, run this analysis to confirm every requirement has task coverage and no constitution conflicts exist before starting /speckit-implement. ## Quick Start Ask the assistant to run the speckit-analyze skill to check consistency across spec.md, plan.md, and tasks.md in the current spec-kit project.

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.md, plan.md, and tasks.md?▼

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

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

Run it after /speckit-tasks has produced a complete tasks.md and before /speckit-implement. The analysis aborts with an error if tasks.md is missing, since task coverage mapping is a core part of the report.

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 edits are only applied if you explicitly approve follow-up commands or edit files manually.

What counts as a critical issue in spec-kit analysis?▼

Critical issues include violations of constitution MUST principles, missing core spec artifacts, and requirements with zero task coverage that block baseline functionality. Critical findings should be resolved before running /speckit-implement.

Why does speckit-analyze fail with a missing file error?▼

The analysis requires spec.md, plan.md, and tasks.md in the feature directory, located via check-prerequisites.sh. If any file is missing, run the corresponding prerequisite command such as /speckit-specify, /speckit-plan, or /speckit-tasks first.