speckit-analyze

Identify inconsistencies and ambiguities across spec.md, plan.md, and tasks.md.

1|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/anishakode/Boring_AI --skill speckit-analyze-anishakode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-analyze
Source: https://github.com/anishakode/Boring_AI/tree/main/.cursor/skills/speckit-analyze
Command: npx skills add https://github.com/anishakode/Boring_AI --skill speckit-analyze-anishakode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Identify inconsistencies, duplications, ambiguities, and underspecified items across spec.md, plan.md, and tasks.md to improve cross-artifact quality before implementation.

Core Features & Use Cases

  • Cross-artifact consistency checks across spec.md, plan.md, and tasks.md.
  • Ambiguity and placeholder detection (e.g., TODOs, TKTK, ???).
  • Coverage mapping and remediation-ready insights to guide task assignments and planning.

Quick Start

Run this skill after tasks.md is generated to produce a structured consistency analysis report for spec.md, plan.md, and tasks.md.

Frequently Asked Questions about speckit-analyze

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

FAQPage Schema
How do I check consistency across spec.md, plan.md, and tasks.md?

Cross-artifact consistency checks validate alignment across spec.md, plan.md, and tasks.md by identifying inconsistencies, duplications, ambiguities, and underspecified items. The analysis generates remediation-ready reports to improve cross-artifact quality before implementation.

What is the best way to detect ambiguities and placeholders in spec-kit artifacts?

Detecting ambiguities and placeholders in spec-kit artifacts involves scanning spec.md, plan.md, and tasks.md for unresolved markers like TODOs, TKTK, or ???. This analysis highlights underspecified items to ensure full requirement coverage before development begins.

When do I need to run cross-artifact traceability mapping for project planning?

You need cross-artifact traceability mapping immediately after task generation produces tasks.md. Running the analysis at this stage verifies that spec.md, plan.md, and tasks.md are fully aligned and helps identify coverage gaps before assigning implementation tasks.

Can I use this analysis on a project that only has a spec.md file?

No, this analysis requires a Speckit-style project where spec.md, plan.md, and tasks.md all exist. It is designed specifically for cross-artifact verification and cannot perform consistency checks if task generation has not yet produced tasks.md.

Why are my generated tasks misaligned with my project plan and specification?

Generated tasks misalign with project plans and specifications due to duplications, ambiguities, or underspecified items introduced during task generation. Running a cross-artifact consistency analysis identifies these gaps and provides remediation-ready insights to realign the documents.

Does the consistency analysis automatically fix gaps found in tasks.md?

No, the consistency analysis does not automatically fix gaps. It produces a structured report with remediation-ready insights and coverage mapping, guiding you on how to resolve inconsistencies and ambiguities across spec.md, plan.md, and tasks.md manually.