speckit-analyze

Identify inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps identify inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md after task generation.

Core Features & Use Cases

  • Surface cross-artifact inconsistencies among spec.md, plan.md, and tasks.md to enable early quality gates.
  • Flag ambiguities and missing mappings between requirements and tasks for targeted remediation.
  • Maintain alignment with the .specify constitution to enforce governance across artifacts.

Quick Start

After task generation, run speckit-analyze to generate a structured analysis report.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check cross-artifact consistency between spec.md, plan.md, and tasks.md?

To check cross-artifact consistency, you can run an analysis on your .specify directory to identify inconsistencies, duplications, and ambiguities across spec.md, plan.md, and tasks.md, generating a structured report without modifying source files.

Why does my generated tasks.md have missing mappings to my spec.md requirements?

Missing mappings between requirements and tasks occur when task generation drifts from the specification. Running a cross-artifact analysis flags these ambiguities and underspecified items for targeted remediation.

What is cross-artifact consistency governance in a spec-kit project structure?

Cross-artifact consistency governance maintains alignment with the .specify constitution, ensuring that spec.md, plan.md, and tasks.md remain synchronized and free of duplications or ambiguities after task generation.

Does the speckit-analyze consistency check modify my source files?

No, the speckit-analyze consistency check does not modify your source files. It outputs a structured analysis report of findings, surfacing inconsistencies and underspecified items for targeted remediation.

When do I need to run a quality audit on my spec-kit project artifacts?

You need to run a quality audit on your spec-kit project artifacts immediately after task generation to surface cross-artifact inconsistencies, enforce governance, and ensure requirements are fully mapped to tasks.

Can I use this analysis tool if my project lacks a .specify directory?

No, this analysis tool specifically applies to projects that follow the spec-kit project structure, requiring a .specify directory containing spec.md, plan.md, and tasks.md to function properly.