speckit-analyze

Analyze spec, plan, and tasks.md files for inconsistencies and quality issues.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/jacobbweber/Zerto-PS-Admin-SDD --skill speckit-analyze-jacobbweber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/jacobbweber/Zerto-PS-Admin-SDD/tree/main/.agent/skills/speckit-analyze
Command: npx skills add https://github.com/jacobbweber/Zerto-PS-Admin-SDD --skill speckit-analyze-jacobbweber

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md so teams can fix specification defects before implementation and avoid wasted engineering effort.

Core Features & Use Cases

  • Cross-artifact consistency checks: Compare requirements, user stories, and task mappings across spec, plan, and tasks to surface mismatches and coverage gaps.
  • Automated semantic modeling & severity scoring: Build requirement and task inventories, map coverage, and assign CRITICAL/HIGH/MEDIUM/LOW severities for prioritized remediation.
  • Actionable reporting: Produce a compact Markdown analysis report with coverage tables, constitution alignment checks, and explicit next actions for project maintainers.
  • Use Case: Run after automated task generation to validate that FR-/SC- identifiers, acceptance criteria, and constitution principles are sampled and implemented by tasks.

Quick Start

Run speckit-analyze after tasks.md has been generated to get a structured inconsistency report and prioritized remediation suggestions.

Frequently Asked Questions about speckit-analyze

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check spec, plan, and tasks inconsistencies before implementation?

To check spec, plan, and tasks inconsistencies, run a cross-artifact consistency analysis after generating tasks.md. This detects mismatches and coverage gaps across spec.md, plan.md, and tasks.md to fix specification defects before implementation.

What is cross-artifact consistency analysis for spec-kit projects?

Cross-artifact consistency analysis for spec-kit projects is a non-destructive validation process that builds requirement and task inventories. It maps coverage and assigns severity scores to surface duplications, ambiguities, and underspecified items across your specification artifacts.

Does the spec-kit analyzer require a specific directory structure to run?

Yes, the spec-kit analyzer requires a project using the spec-kit layout with a .specify directory. It needs read-only repository access and executes the check-prerequisites.ps1 script to locate the FEATURE_DIR before parsing your specification files.

When should I run a spec, plan, and tasks consistency check?

You should run a spec, plan, and tasks consistency check immediately after automated task generation. Running it at this stage validates that FR-/SC- identifiers and acceptance criteria are correctly mapped before starting implementation.

How do I validate constitution alignment in my specification documents?

To validate constitution alignment, the analysis parses your constitution rules alongside spec.md, plan.md, and tasks.md. It checks that constitution principles are properly sampled and implemented by tasks, surfacing any alignment failures.

What is the best way to prioritize specification defects found in spec-kit?

The best way to prioritize specification defects is using the automated severity scoring system. It assigns CRITICAL, HIGH, MEDIUM, or LOW severities to mismatches and coverage gaps, providing explicit next actions in a Markdown report for prioritized remediation.