speckit-analyze

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

9|1|Updated Jul 21, 2025
One-click install
npx skills add https://github.com/usepowershell/PoshMcp --skill speckit-analyze-usepowershell
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/usepowershell/PoshMcp/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/usepowershell/PoshMcp --skill speckit-analyze-usepowershell

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill performs a non-destructive, read-only analysis that finds inconsistencies, duplications, ambiguities, and coverage gaps across spec.md, plan.md, and tasks.md after task generation so teams can catch implementation-blocking issues before work begins.

Core Features & Use Cases

  • Cross-artifact consistency checks: Compares requirements, success criteria, user stories, and tasks to identify missing mappings and conflicting directives.
  • Constitution validation: Flags any conflicts with the project constitution (.specify/memory/constitution.md) as CRITICAL issues.
  • Coverage and severity reporting: Produces a compact, token-efficient Markdown report with categorized findings, coverage tables, and prioritized next actions for remediation.
  • Safe read-only operation: Requires the prerequisites check and explicitly prohibits file edits unless the user requests follow-up remediation suggestions.

Quick Start

Run the speckit-analyze skill with an optional focus argument to produce a structured, read-only consistency report for the feature's spec, plan, and tasks.

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 task files for inconsistencies?

To check spec, plan, and task files for inconsistencies, analyze the spec.md, plan.md, and tasks.md artifacts to identify missing mappings, duplication, ambiguity, and coverage gaps across requirements and tasks.

What is cross-artifact consistency analysis for requirements and tasks?

Cross-artifact consistency analysis compares requirements, success criteria, user stories, and tasks across spec, plan, and task files to identify missing mappings and conflicting directives before implementation begins.

How do I validate generated tasks against a project constitution?

You can validate generated tasks against a project constitution by checking the .specify/memory/constitution.md file, which flags any MUST-level conflicts with requirements or plans as CRITICAL issues.

Can I analyze spec-kit artifacts without modifying my files?

Yes, you can perform a non-destructive, read-only analysis of spec-kit artifacts that explicitly prohibits file edits, only producing a structured Markdown report unless you explicitly request follow-up remediation suggestions.

Do I need a prerequisites check to analyze spec, plan, and task files?

Yes, you need to run the .specify/scripts/powershell/check-prerequisites.ps1 script to output JSON artifact paths, which are required to locate and validate the spec, plan, and task files.

Why are my spec-kit tasks missing coverage for certain requirements?

Tasks may lack coverage for certain requirements due to gaps during task generation; analyzing the artifacts produces coverage tables that identify these missing mappings and prioritizes remediation actions.