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.