speckit-analyze

Analyze spec.md, plan.md, and tasks.md for inconsistencies and coverage gaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires powershell.

What problem does it solve?

It prevents mismatches and quality gaps between your spec.md, plan.md, and tasks.md by performing a cross-artifact consistency and quality check after task generation.

Core Features & Use Cases

  • Non-destructive cross-artifact validation: Detects duplication, ambiguity, underspecification, coverage gaps, and terminology drift across spec.md, plan.md, and tasks.md without modifying files.
  • Constitution-aware guardrails: Validates against the non-negotiable project constitution and flags MUST principle conflicts as critical.
  • Readiness reporting: Produces a structured analysis report with coverage mapping and next-action recommendations before implementation.

Quick Start

Run the speckit-analyze skill after tasks.md is generated so it can report inconsistencies and coverage gaps across your artifacts.

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.md, plan.md, and tasks.md?

Cross-artifact consistency analysis detects duplication, ambiguity, underspecification, and coverage gaps across spec.md, plan.md, and tasks.md without modifying your files.

What is constitution validation in task generation?

Constitution validation checks generated tasks against non-negotiable project principles, flagging any MUST principle conflicts as critical severity findings in the analysis report.

How do I map requirements to tasks to find coverage gaps?

Mapping requirements to tasks builds a semantic inventory from spec and plan artifacts, then cross-references them against tasks.md to identify coverage gaps before implementation begins.

Does speckit-analyze work with PowerShell on Windows?

Yes, speckit-analyze requires PowerShell as a dependency to validate required files via a prerequisite script and perform non-destructive quality assurance analysis on speckit project artifacts.

When should I run a read-only audit on my specification and task files?

Run a read-only audit immediately after task generation to validate readiness, ensuring spec.md, plan.md, and tasks.md are consistent and fully cover requirements before starting implementation.

Why does my tasks.md have terminology drift from the original spec?

Terminology drift occurs when task definitions diverge from original specifications; performing a consistency analysis identifies this drift by comparing semantic inventories across spec, plan, and task artifacts.