speckit-analyze

Detect inconsistencies across spec.md, plan.md, and tasks.md files.

Updated Nov 23, 2023
One-click install
npx skills add https://github.com/auleewilliams/Skillscape --skill speckit-analyze-auleewilliams
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/auleewilliams/Skillscape/tree/main/.claude/skills/speckit-analyze
Command: npx skills add https://github.com/auleewilliams/Skillscape --skill speckit-analyze-auleewilliams

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams ensure alignment across specification artifacts by identifying inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md.

Core Features & Use Cases

  • Cross-artifact inconsistency detection across spec.md, plan.md, and tasks.md
  • Duplication and ambiguity identification with clear remediation suggestions
  • Constitution alignment checks against MUST principles

Quick Start

Review the three artifacts and generate a findings report.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I find inconsistencies across spec, plan, and tasks files?▼

Cross-artifact inconsistency detection compares spec.md, plan.md, and tasks.md to identify duplications, ambiguities, and underspecified items. It checks constitution alignment against MUST principles and outputs a structured analysis report for remediation planning.

What are common cross-artifact inconsistencies in spec-kit project structures?▼

Common inconsistencies include duplications across spec.md, plan.md, and tasks.md, ambiguities in requirements, underspecified items, and misalignment with MUST constitution principles. The analysis generates a structured findings report for remediation.

How do I check if my plan and tasks align with my spec.md?▼

To check alignment, analyze spec.md, plan.md, and tasks.md together to detect ambiguities, duplications, and underspecified items. The process verifies constitution alignment against MUST principles and outputs a structured findings report for remediation.

Does spec-kit inconsistency analysis require all three artifacts to run?▼

Yes, this analysis requires complete spec.md, plan.md, and tasks.md artifacts. The cross-artifact detection applies to projects following the spec-kit project structure with all three files present to identify duplications, ambiguities, and underspecified items.

What is the best way to detect underspecified items in project specifications?▼

The best way to detect underspecified items is to run a cross-artifact analysis across spec.md, plan.md, and tasks.md. This identifies underspecified requirements, detects duplications and ambiguities, and generates a structured report with clear remediation suggestions.

Why does my tasks.md contain duplications not present in spec.md?▼

Duplications occur due to cross-artifact inconsistencies between spec.md, plan.md, and tasks.md. Running an inconsistency analysis identifies these duplications alongside ambiguities and underspecified items, providing clear remediation suggestions in a structured findings report.