speckit-analyze

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Speckit-analyze prevents implementation churn by finding inconsistencies, duplicates, ambiguities, and underspecified items across your core Spec Kit artifacts before work begins.

Core Features & Use Cases

  • Cross-artifact consistency checks: Compare spec.md, plan.md, and tasks.md to detect drift in requirements, terminology, and coverage.
  • Quality and completeness validation: Surface vague success criteria, placeholders, and missing measurable outcomes that would otherwise stall engineering.
  • Constitution-aligned enforcement: Validate against .specify/memory/constitution.md and report critical conflicts as actionable gaps.

Quick Start

Run speckit-analyze after /speckit.tasks has produced a complete tasks.md to generate a structured, read-only analysis report across the three artifacts.

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.md, plan.md, and tasks.md for consistency before coding?▼

Cross-artifact consistency checking compares spec.md, plan.md, and tasks.md to detect drift in requirements, terminology, and coverage. It generates a structured, read-only findings report covering duplication, ambiguity, underspecification, and inconsistencies to prevent implementation churn.

What is cross-artifact spec analysis in a Spec Kit project?▼

Cross-artifact spec analysis is a non-destructive validation process that reads core Spec Kit artifacts within the .specify/ directory structure. It surfaces vague success criteria, placeholders, and missing measurable outcomes to ensure documentation quality before engineering work begins.

How do I validate generated tasks against project constitution principles?▼

Constitution-aligned enforcement validates generated tasks against .specify/memory/constitution.md to identify critical conflicts. It reports actionable gaps where task definitions or plans deviate from established project principles before implementation starts.

When should I run spec and task coverage validation in my workflow?▼

Run spec and task coverage validation after task generation produces a complete tasks.md file. This timing ensures all three core artifacts exist for cross-checking, allowing you to resolve coverage gaps and underspecified items before any coding effort begins.

Does spec analysis modify my existing Spec Kit documentation files?▼

Spec analysis enforces strict read-only reporting, meaning your existing spec.md, plan.md, and tasks.md files are never modified. The process only outputs a structured findings report identifying documentation QA issues for manual resolution.

Why does my tasks.md have coverage gaps compared to my spec.md?▼

Coverage gaps occur when generated tasks fail to fully implement requirements defined in spec.md. Cross-artifact consistency checking identifies these missing task-to-spec mappings and reports them as structured findings alongside any terminology drift or underspecified items.