speckit-analyze

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

Updated Dec 26, 2025
One-click install
npx skills add https://github.com/BOUROUIS-MOHAMED/monclub_access_python --skill speckit-analyze-bourouis-mohamed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/BOUROUIS-MOHAMED/monclub_access_python/tree/main/.agents/skills/speckit-analyze
Command: npx skills add https://github.com/BOUROUIS-MOHAMED/monclub_access_python --skill speckit-analyze-bourouis-mohamed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Perform a non-destructive cross-artifact consistency and quality analysis across spec.md, plan.md, and tasks.md after task generation.

Core Features & Use Cases

  • Read-only analysis to surface duplications, ambiguities, and underspecified items across core artifacts.
  • Constitution-aware validation to ensure alignment with the .specify/memory/constitution.md principles.
  • Output a compact report with optional remediation guidance for approved edits.

Quick Start

Run speckit-analyze from the repository root after /speckit.tasks has produced a complete tasks.md to generate an analysis 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 for inconsistencies across spec.md, plan.md, and tasks.md?

Cross-artifact consistency analysis detects duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md. It runs as a read-only review after task generation to surface discrepancies early in the specification workflow.

When should I run cross-artifact analysis in the specification workflow?

Run cross-artifact analysis after /speckit.tasks has produced a complete tasks.md. Executing it at this stage ensures your plan and tasks align with the specification before implementation begins, preventing costly downstream errors.

Does cross-artifact consistency analysis modify my specification files?

No, cross-artifact consistency analysis is a non-destructive, read-only process. It outputs a compact report with optional remediation guidance, ensuring your original spec.md, plan.md, and tasks.md files remain unchanged during the review.

How do I validate my project tasks against the constitution.md principles?

Constitution-aware validation checks your generated tasks and plans against the .specify/memory/constitution.md principles. This ensures your project artifacts maintain alignment with established governance rules throughout the analysis report.

What is the best way to find ambiguities and duplications in software specification documents?

Analyzing software specification documents for ambiguities and duplications involves cross-referencing the spec, plan, and tasks files. A dedicated consistency checker compares these artifacts to identify overlapping items and vague requirements automatically.

What do I need to generate an analysis report for my project tasks?

You need a complete tasks.md generated by the /speckit.tasks command, alongside your spec.md and plan.md files. Running the analysis from the repository root processes these artifacts to produce a compact consistency report.