speckit-analyze

Analyze spec.md, plan.md, and tasks.md for inconsistencies and gaps.

Updated Apr 17, 2026
One-click install
npx skills add https://github.com/nalthoff/spec-kit-prep-specify --skill speckit-analyze-nalthoff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/nalthoff/spec-kit-prep-specify/tree/main/.cursor/skills/speckit-analyze
Command: npx skills add https://github.com/nalthoff/spec-kit-prep-specify --skill speckit-analyze-nalthoff

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill identifies inconsistencies, duplications, ambiguities, and underspecifications across spec.md, plan.md, and tasks.md to ensure alignment before implementation.

Core Features & Use Cases

  • Cross-artifact consistency checks across spec.md, plan.md, and tasks.md
  • Duplication and ambiguity detection with actionable remediation notes
  • Coverage mapping to reveal gaps where tasks have no associated requirements
  • Use Case: Teams run this after task generation to surface critical risks and maintain alignment.

Quick Start

Run the analysis after task generation to surface inconsistencies and publish a compact report.

Frequently Asked Questions about speckit-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check for inconsistencies across spec, plan, and task files before implementation?

To check for inconsistencies across spec, plan, and task files, you analyze the artifacts to surface duplications, ambiguities, and underspecifications. This process produces a compact report with remediation recommendations and traceable mappings between requirements, stories, and tasks.

What is cross-artifact consistency analysis in a spec-kit project structure?

Cross-artifact consistency analysis in a spec-kit project structure identifies gaps where tasks lack associated requirements and validates conformance to the constitution. It ensures alignment across spec.md, plan.md, and tasks.md before implementation.

When do I need to run a consistency check on generated tasks?

You need to run a consistency check on generated tasks immediately after task generation. Running the analysis at this stage surfaces critical risks, validates constitution conformance, and maintains alignment before implementation.

Does spec analysis map requirements to stories and tasks for coverage tracking?

Yes, spec analysis maps requirements to stories and tasks to provide coverage tracking. This mapping reveals gaps where tasks have no associated requirements and highlights duplications across the spec.md, plan.md, and tasks.md artifacts.

What is the best way to detect underspecifications in software planning artifacts?

The best way to detect underspecifications in software planning artifacts is to perform an automated cross-artifact analysis. This approach identifies ambiguities and gaps across your spec, plan, and tasks, generating actionable remediation notes.

Can I validate conformance to the constitution using spec artifact analysis?

Yes, you can validate conformance to the constitution using spec artifact analysis. The analysis operates within your project structure to verify that your generated tasks and plans adhere to the defined constitutional constraints.