speckit-analyze

Analyze spec, plan, and task artifacts for inconsistencies and requirement coverage.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identifies inconsistencies, duplications, ambiguities, and underspecified requirements across spec.md, plan.md, and tasks.md in a read-only, non-destructive way so teams can fix specification and planning gaps before implementation.

Core Features & Use Cases

  • Enforces project constitution rules by flagging any conflicts with .specify/memory/constitution.md and marking them as CRITICAL.
  • Loads minimal artifact context, builds semantic requirement and task coverage mappings, detects duplication, ambiguity, underspecification, and assigns severity to findings.
  • Produces a concise, structured Markdown analysis report with coverage tables and next-action recommendations for product managers and engineering leads preparing to implement work.

Quick Start

Run the speckit-analyze skill on the repository root to generate a read-only structured analysis report for spec.md, plan.md, and tasks.md.

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 between spec, plan, and task files?

To check for inconsistencies between spec, plan, and task files, run a read-only analysis that loads minimal context and builds semantic requirement and task coverage mappings to flag duplications, ambiguities, and underspecified requirements.

How do I map task coverage to requirements in a spec-kit repository?

Mapping task coverage to requirements involves loading spec.md, plan.md, and tasks.md from your FEATURE_DIR to create a semantic inventory. This identifies which requirements are fully covered by tasks and highlights any specification gaps.

Can I enforce constitution rules when analyzing spec and plan artifacts?

Yes, you can enforce constitution rules during artifact analysis by checking spec.md, plan.md, and tasks.md against .specify/memory/constitution.md. Any conflicts found are flagged as CRITICAL severity in the final structured Markdown report.

Does spec, plan, and task analysis modify my existing repository files?

No, spec, plan, and task analysis is strictly non-destructive. It performs a read-only load of your artifacts to evaluate coverage and assign severity to findings, ensuring your original specification files remain completely unchanged.

What is the best way to detect underspecified requirements before implementation?

The best way to detect underspecified requirements is to generate a structured Markdown analysis report that inventories requirements semantically and maps task coverage. This highlights ambiguities and missing details for product managers to resolve.

Why are some spec and plan inconsistencies marked as CRITICAL in my analysis?

Spec and plan inconsistencies are marked as CRITICAL when they directly conflict with the project's established constitution rules defined in .specify/memory/constitution.md. Other findings receive severity assignments based on duplication or ambiguity levels.