skills.rest
alex-jordan547
alex-jordan547COMMUNITY
Explore all skills by this author →
GitHub

speckit-analyze

Analyzes spec.md, plan.md, and tasks.md for inconsistencies, gaps, and duplications.

Updated Jul 3, 2026
Search Tags:#spec-kit#task validation#requirements coverage#specification review#read-only analysis#consistency analysis
One-click install
npx skills add https://github.com/alex-jordan547/agent-setup --skill speckit-analyze-alex-jordan547
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/alex-jordan547/agent-setup/tree/main/archive/speckit-analyze
Command: npx skills add https://github.com/alex-jordan547/agent-setup --skill speckit-analyze-alex-jordan547

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Before implementation begins, specification artifacts often contain contradictions, ambiguous requirements, and uncovered tasks that cause costly rework. This Skill performs a read-only cross-artifact consistency analysis so teams catch these issues early. ## Core Features & Use Cases - Cross-Artifact Analysis: Detects duplications, ambiguities, underspecification, inconsistencies, and coverage gaps across spec.md, plan.md, and tasks.md. - Severity-Ranked Report: Produces a structured Markdown report with CRITICAL/HIGH/MEDIUM/LOW findings, coverage metrics, and constitution alignment checks. - Constitution Enforcement: Treats violations of .specify/memory/constitution.md MUST principles as automatically CRITICAL. - Use Case: After running /speckit.tasks on a new feature, run this analysis to confirm every requirement has task coverage and no conflicting stack choices exist before starting /speckit.implement. ## Quick Start Ask the agent to run a cross-artifact consistency analysis on the current spec-kit feature's spec.md, plan.md, and tasks.md before implementation.

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-kit artifacts for inconsistencies before implementation?▼

Run the speckit-analyze skill after /speckit.tasks completes. It loads spec.md, plan.md, and tasks.md, maps requirements to tasks, and outputs a severity-ranked report of duplications, ambiguities, and coverage gaps without modifying any files.

What does the specification analysis report include?▼

The report contains a findings table with ID, category, severity, location, and recommendation, plus a requirement-to-task coverage summary, constitution alignment issues, unmapped tasks, and metrics like coverage percentage and ambiguity counts.

Does speckit-analyze modify my spec or task files?▼

No, the analysis is strictly read-only. It outputs a structured report and optionally suggests remediation edits, but changes are only applied after explicit user approval through separate commands.

When should I run cross-artifact analysis in a spec-kit workflow?▼

Run it after /speckit.tasks has produced a complete tasks.md and before /speckit.implement. It requires the .specify project structure and aborts with an error if any required artifact is missing.

How are constitution violations handled during analysis?▼

Any requirement or plan element conflicting with a MUST principle in .specify/memory/constitution.md is automatically classified as CRITICAL. The constitution cannot be diluted or reinterpreted within the analysis scope.

Related Skills

Explore More Software Engineering Skills→
FarooqProProgrammerFarooqProProgrammer

sdd-pipeline

Orchestrates spec-driven development from constitution through specification, planning, tasks, and implementation.

Community
Intermediate
ArkLabsHQArkLabsHQ
3

dev-implement

Execute implementation tasks via the /speckit.implement command for production code.

Official
Basic
dwbdwb

test-driven-development

Guide writing a failing test before implementing code to pass it.

Community
Basic
WayneSHCWayneSHC
1

speckit-checklist

Generate custom checklists to validate feature requirements in spec-kit projects.

Community
Advanced