speckit-analyze

Analyze spec.md, plan.md, and tasks.md for consistency and quality.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill performs a cross-artifact consistency and quality analysis to detect mismatches, duplications, ambiguities, and underspecified items before implementation begins.

Core Features & Use Cases

  • Pre-implementation consistency review: Checks the alignment between spec.md, plan.md, and tasks.md after tasks generation.
  • Quality and coverage diagnostics: Flags duplication, ambiguity, underspecification, constitution conflicts, coverage gaps, and inconsistencies, producing a structured report with metrics.
  • Guided next actions: Recommends whether to halt for CRITICAL issues or proceed with improvements when only lower-severity issues remain.

Quick Start

Run the speckit-analyze command after generating tasks.md so it can validate that tasks fully cover the requirements and success criteria in spec.md and plan.md.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check consistency between spec, plan, and tasks files before implementation?

Run cross-artifact consistency analysis on spec.md, plan.md, and tasks.md after task generation to detect mismatches, duplications, and ambiguities. It builds semantic models to catch spec-plan-task inconsistencies early before implementation begins.

What is requirements traceability and coverage analysis for project documentation?

Requirements traceability analysis validates that tasks.md fully covers requirements and success criteria defined in spec.md and plan.md. It identifies coverage gaps and underspecified items, ensuring complete documentation before development starts.

How do I detect duplication and ambiguity in specification documents?

Apply semantic modeling to specification, planning, and task documents to flag overlapping definitions and unclear requirements. This produces a structured quality report with specific metrics and recommended next actions for resolution.

Does spec-plan-task analysis work with Speckit and spec-kit project structures?

Yes, consistency analysis targets Speckit projects using the spec-kit project structure with FEATURE_DIR-derived artifacts and the required constitution file. It performs read-only reporting to ensure non-destructive validation of existing documentation.

When should I run documentation validation after generating tasks?

Run documentation validation immediately after generating tasks.md to verify that tasks fully cover requirements and success criteria in spec.md and plan.md. This confirms spec-plan-task alignment before implementation begins.

What are the limitations of read-only consistency analysis for project planning?

Read-only consistency analysis is limited to non-destructive reporting without modifying artifacts. It cannot auto-fix detected issues, but recommends whether to halt for CRITICAL issues or proceed with improvements for lower-severity problems.