speckit-analyze

Analyzes spec.md, plan.md and tasks.md for inconsistencies and gaps, outputting a structured report without modifying files.

Updated Feb 26, 2026
One-click install
npx skills add https://github.com/tomlm/Boxcars --skill speckit-analyze-tomlm
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/tomlm/Boxcars/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/tomlm/Boxcars --skill speckit-analyze-tomlm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify and report non-destructive inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md after task generation, enabling early quality gates before implementation.

Core Features & Use Cases

  • Analyze cross-artifact coherence to surface duplications and gaps between requirements, plans, and tasks.
  • Produce a structured analysis report and an optional remediation plan (user must approve before any edits).
  • Enforce constitution compliance by validating against the .specify/memory/constitution.md principles.

Quick Start

Provide an analysis-ready report without editing any files.

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 consistency after task generation?▼

To check consistency, cross-reference spec.md, plan.md, and tasks.md to identify duplications, ambiguities, and coverage gaps. This analysis validates artifacts against your constitution to enforce MUST violations and outputs a structured report without modifying files.

What is cross-artifact coherence analysis for software specifications?▼

Cross-artifact coherence analysis surfaces non-destructive inconsistencies, duplications, and underspecified items across spec.md, plan.md, and tasks.md. It enables early quality gates by producing a structured report of alignment issues before implementation begins.

Does consistency analysis modify my spec, plan, or tasks files?▼

Consistency analysis does not modify spec, plan, or tasks files. It operates on the completed tasks.md to output a structured analysis report and an optional remediation plan, which requires explicit user approval before any edits are applied.

How do I validate generated tasks against constitution principles?▼

Validate generated tasks against constitution principles by checking the completed tasks.md for MUST violations using the rules in .specify/memory/constitution.md. This process flags alignment issues and coverage gaps across all specification artifacts.

Can I use this analysis for spec and plan files without any dependencies?▼

Yes, you can analyze spec, plan, and tasks files without external dependencies. The analysis runs directly on your existing markdown artifacts to identify ambiguities and underspecified items, requiring only a completed tasks.md to generate the coherence report.

What's the best way to find coverage gaps between requirements and tasks?▼

The best way to find coverage gaps is cross-referencing requirements in spec.md against the generated tasks.md. This surfaces underspecified items and alignment issues, producing an optional remediation plan to address gaps before you start implementation.