speckit-analyze

Analyze spec.md, plan.md, and tasks.md for consistency and quality gaps.

Updated Apr 4, 2026
One-click install
npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-analyze-misadecastro
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/misadecastro/imperial-soccer/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/misadecastro/imperial-soccer --skill speckit-analyze-misadecastro

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious and error-prone manual review of specification, plan, and task artifacts by producing a focused, read-only consistency and quality analysis before implementation begins.

Core Features & Use Cases

  • Cross-artifact Consistency Checks: Detects duplications, conflicting requirements, and terminology drift across spec.md, plan.md, and tasks.md.
  • Constitution Validation & Severity Triage: Flags violations of project constitution principles as CRITICAL and assigns severity to other findings.
  • Coverage Mapping & Gap Detection: Maps tasks to requirements and highlights unmapped requirements or tasks lacking traceability; useful as a gate before implementation handoff.

Quick Start

Analyze the feature's SPEC, PLAN, and TASKS files and produce a compact Markdown analysis report that lists inconsistencies, coverage gaps, and recommended next actions.

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 files for inconsistencies before implementation?

Mapping requirements to tasks involves tracing each specification entry to its corresponding task entry to identify unmapped requirements or tasks lacking traceability. This semantic requirement-to-task mapping highlights coverage gaps before implementation handoff.

What is the best way to detect coverage gaps between spec.md and tasks.md?

The best way to detect coverage gaps is to perform semantic requirement-to-task mapping across your spec.md and tasks.md files. This highlights unmapped requirements or orphaned tasks lacking traceability before implementation begins.

Does cross-artifact analysis modify my spec, plan, and tasks repository files?

No, cross-artifact consistency analysis is a non-destructive, read-only process. It evaluates your spec, plan, and tasks files and produces a compact Markdown analysis report without modifying your original repository files.

How do I flag constitution conflicts and severity levels in a spec-kit feature directory?

To flag constitution conflicts in a spec-kit feature directory, the analysis validates artifacts against project constitution principles, marking violations as CRITICAL. It also assigns severity classifications to other findings like ambiguities and duplications.

When do I need to run a consistency and quality analysis on specification artifacts?

You need to run a consistency and quality analysis on specification artifacts when preparing for implementation handoff. It serves as a validation gate to catch terminology drift, underspecification, and coverage gaps across your spec, plan, and tasks files.