speckit-analyze

Analyze spec, plan, and task files for inconsistencies and ambiguities.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/nShieldSolo/ArcticFactory.Preset --skill speckit-analyze-nshieldsolo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/nShieldSolo/ArcticFactory.Preset/tree/main/.agent/skills/speckit-analyze
Command: npx skills add https://github.com/nShieldSolo/ArcticFactory.Preset --skill speckit-analyze-nshieldsolo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects inconsistencies, duplications, ambiguities, and underspecified items across specification, plan, and task artifacts to prevent implementation surprises and rework before coding begins.

Core Features & Use Cases

  • Cross-artifact analysis: Compares spec, plan, and tasks to find missing coverage, conflicting requirements, and terminology drift.
  • Constitution validation: Validates findings against the project constitution and flags any MUST-level violations as critical.
  • Actionable reporting: Outputs a structured, severity-ranked report with coverage tables and suggested next actions for remediation.
  • Use Case: After speckit.tasks generates tasks.md, run this Skill to verify task coverage, detect ambiguous acceptance criteria, and confirm constitution alignment prior to implementation.

Quick Start

Run the speckit.analyze command after tasks.md is produced to generate a read-only analysis report highlighting inconsistencies and 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 audit spec, plan, and task files for inconsistencies before implementation?

To audit spec, plan, and task files for inconsistencies, apply an analysis tool to your Spec Kit project directory. It cross-analyzes spec.md, plan.md, and tasks.md to detect missing coverage, conflicting requirements, and terminology drift, producing a structured, severity-ranked report with suggested remediation steps.

What does constitution validation check in a Spec Kit project?

Constitution validation checks your project artifacts against defined constitution principles to flag any MUST-level violations as critical. It ensures your generated tasks and plans align strictly with foundational project rules before coding begins.

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

Mapping requirements to tasks involves cross-referencing spec.md and tasks.md to identify duplications, ambiguities, and underspecified items. The analysis generates a coverage table that highlights gaps and validates alignment with the original specification.

Does the spec audit require a specific directory structure?

Yes, the spec audit requires a Spec Kit project that includes a .specify directory. The analysis applies to the FEATURE_DIR spec.md, plan.md, and tasks.md files after task generation and before implementation to ensure accurate cross-artifact validation.

When should I run a spec, plan, and task consistency analysis?

You should run a spec, plan, and task consistency analysis immediately after tasks.md is produced and before implementation begins. This early detection prevents implementation surprises and rework by verifying task coverage and confirming constitution alignment.

What is the best way to find ambiguities in generated task lists?

The best way to find ambiguities in generated task lists is to cross-analyze tasks.md against spec.md and plan.md. This detects underspecified items and terminology drift, outputting a read-only structured analysis report that assigns severity levels and suggests remediation actions.