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.