speckit-analyze

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

130|14|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/dmae97/oh-my-kimi --skill speckit-analyze-dmae97
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/dmae97/oh-my-kimi/tree/main/templates/skills/kimi/speckit-analyze
Command: npx skills add https://github.com/dmae97/oh-my-kimi --skill speckit-analyze-dmae97

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill identifies inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md so you don’t implement the wrong requirements or miss critical constraints.

Core Features & Use Cases

  • Cross-artifact consistency analysis: Compares the same concepts across spec.md, plan.md, and tasks.md to find drift and gaps.
  • Quality gating for build readiness: Detects duplication, ambiguity, missing measurable criteria, and coverage gaps before implementation.
  • Constitution-aware compliance checks: Validates MUST/SHOULD principles against the project constitution and flags conflicts as critical.
  • Extension hook support (read-only): Runs optional before/after hooks defined in .specify/extensions.yml without interpreting hook conditions.

Quick Start

Run speckit-analyze after speckit-tasks has generated tasks.md to get a structured report of inconsistencies and coverage gaps.

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 task consistency before implementation?

Spec, plan, and task consistency is checked by performing cross-artifact analysis across spec.md, plan.md, and tasks.md to detect drift, duplication, ambiguity, and coverage gaps before building. The process produces a structured Markdown report highlighting mismatches and underspecified items.

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

Cross-artifact quality analysis compares the same concepts across spec.md, plan.md, and tasks.md to find inconsistencies and missing measurable criteria. It serves as a quality gate for build readiness by identifying ambiguities and coverage gaps in the project specification.

How do I validate constitution compliance against spec and plan files?

Constitution compliance is validated by checking MUST and SHOULD principles against the project constitution and flagging any conflicts as critical. This ensures the specification and plan align with the governance rules defined in the .specify directory.

Does the spec-plan-task analysis modify my project files during checking?

Spec-plan-task analysis is strictly non-destructive and reads files only without modifying any project artifacts. It runs optional before and after hooks defined in .specify/extensions.yml without interpreting hook conditions, ensuring your files remain unchanged.

When do I need to run cross-artifact consistency checking on my tasks?

Cross-artifact consistency checking is needed immediately after generating tasks.md to catch mismatches early. Running it before implementation ensures you do not build the wrong requirements or miss critical constraints defined in the specification.

What are the limitations of using consistency checking for spec-plan-task gaps?

Consistency checking for spec-plan-task gaps is limited to read-only analysis and requires a .specify project structure with constitution-based governance. It does not interpret extension hook conditions or automatically fix the detected duplication, ambiguity, or coverage issues.