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.