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.