speckit-analyze

Analyze spec.md, plan.md, and tasks.md for inconsistencies before implementation.

1|Updated Oct 21, 2025
One-click install
npx skills add https://github.com/code-dot-org/marketing-sites --skill speckit-analyze-code-dot-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/code-dot-org/marketing-sites/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/code-dot-org/marketing-sites --skill speckit-analyze-code-dot-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps identify inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md before implementation, ensuring alignment with the project constitution.

Core Features & Use Cases

  • Cross-artifact quality analysis across spec.md, plan.md, and tasks.md after task generation.
  • Generates structured reports with optional remediation plans and explains findings for quick risk mitigation.
  • Validates alignment with .specify/memory/constitution.md.

Quick Start

Run the speckit-analyze command after speckit.tasks has produced a complete 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 find inconsistencies across spec.md, plan.md, and tasks.md before implementation?

To find inconsistencies across spec.md, plan.md, and tasks.md, analyze the artifacts for duplications, ambiguities, and underspecified items before code changes. This cross-artifact analysis identifies misalignments early and returns a structured report with an optional remediation plan.

When should I run a cross-artifact quality analysis in a speckit project?

Cross-artifact quality analysis should run after task generation produces a complete tasks.md and before any code changes. This timing ensures you validate alignment and identify underspecified items early, preventing implementation drift in your speckit project structure.

How does constitution validation work during spec analysis?

Constitution validation works by checking your spec.md, plan.md, and tasks.md against the .specify/memory/constitution.md file. This read-only analysis enforces project rules while generating a structured report of any constitutional misalignments found across artifacts.

Can I automatically generate a remediation plan for underspecified items in my spec?

Yes, analyzing your artifacts can automatically generate an optional remediation plan for underspecified items, duplications, and ambiguities. The analysis returns this plan alongside a structured report to guide quick risk mitigation before implementation begins.

What are the limitations of read-only analysis for spec and plan artifacts?

The limitation of read-only analysis is that it cannot directly modify your spec.md, plan.md, or tasks.md files. It strictly identifies inconsistencies and validates the constitution, returning a structured report and remediation plan for you to apply manually.

Does speckit-analyze work after generating tasks.md with speckit.tasks?

Yes, speckit-analyze works specifically after the speckit.tasks command has produced a complete tasks.md file. It evaluates the generated tasks against your spec.md and plan.md to find cross-artifact inconsistencies before you start coding.