speckit-analyze

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill performs a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation, helping teams surface inconsistencies and ambiguities before implementation.

Core Features & Use Cases

  • Identify inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md.
  • Produce a structured analysis report with an optional remediation plan that requires explicit user approval before any edits.
  • Respect the project constitution and highlight conflicts that violate MUST principles.

Quick Start

Run the speckit-analyze analysis after the speckit.tasks phase completes to generate the 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 consistency across spec.md, plan.md, and tasks.md?

Cross-artifact consistency analysis identifies inconsistencies, duplications, and ambiguities across spec.md, plan.md, and tasks.md. It produces a structured report after task generation, highlighting conflicts and underspecified items before implementation begins.

Can I analyze spec artifacts without modifying the original files?

Yes, cross-artifact consistency analysis enforces strict read-only analysis of spec.md, plan.md, and tasks.md. It generates a structured report without editing source files, and any proposed remediation plan requires explicit user approval before execution.

When do I need to run cross-artifact consistency analysis in a .specify project?

Run cross-artifact consistency analysis after the speckit.tasks phase completes and produces a complete tasks.md within a .specify project structure. This timing ensures all three artifacts exist and are ready for quality and consistency validation.

How does artifact quality analysis handle project constitution violations?

Artifact quality analysis references the project constitution during validation to highlight conflicts that violate MUST principles. It surfaces these constitutional violations within the structured analysis report, ensuring foundational project rules are respected.

What's the best way to resolve ambiguities found across spec, plan, and tasks artifacts?

The best way to resolve ambiguities is through the optional remediation plan proposed after consistency analysis. This plan requires explicit user approval before any edits are made, ensuring controlled and reviewed fixes for underspecified items and duplications.

Does cross-artifact analysis work without a complete tasks.md file?

No, cross-artifact analysis operates after speckit.tasks has produced a complete tasks.md within the .specify project structure. A fully generated tasks.md is required to accurately identify inconsistencies and ambiguities across all three artifacts.