speckit-analyze

Analyze spec.md, plan.md, and tasks.md for cross-artifact inconsistencies and coverage gaps.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill detects inconsistencies, ambiguities, duplications, and coverage gaps across spec.md, plan.md, and tasks.md so teams catch specification issues before implementation and avoid rework.

Core Features & Use Cases

  • Cross-artifact Consistency Checks: Compare requirements, user stories, and tasks to surface missing or conflicting entries.
  • Constitution Compliance Validation: Enforce MUST-level principles from .specify/memory/constitution.md and flag violations as critical.
  • Coverage & Ambiguity Detection: Identify requirements without tasks, tasks without requirements, vague acceptance criteria, and unresolved placeholders for focused remediation.

Quick Start

Run speckit-analyze to scan the feature's spec.md, plan.md, and tasks.md and produce a compact, prioritized 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 consistency between spec.md, plan.md, and tasks.md before implementation?

To check consistency between spec.md, plan.md, and tasks.md, run a cross-artifact analysis to detect missing entries, conflicting requirements, and coverage gaps across your documents before implementation begins.

What happens when tasks.md has missing or conflicting requirements?

When tasks.md has missing or conflicting requirements, cross-artifact analysis identifies requirements without tasks and tasks without requirements, flagging these coverage gaps and unresolved placeholders for focused remediation.

How do I validate project artifacts against constitution rules?

To validate project artifacts against constitution rules, compliance checks enforce MUST-level principles from .specify/memory/constitution.md, scanning artifacts and flagging any violations as critical issues in the report.

Does spec-kit analysis work without a .specify directory?

Spec-kit analysis requires a .specify directory because it reads constitution rules from .specify/memory/constitution.md for normative validation and accesses FEATURE_DIR artifacts to perform non-destructive cross-artifact checks.

How do I detect vague acceptance criteria in my spec and plan?

To detect vague acceptance criteria in your spec and plan, a quality analysis scans for unresolved placeholders and ambiguities across spec.md, plan.md, and tasks.md, producing a prioritized report for remediation.

Can I run consistency checks on an incomplete tasks.md file?

Running consistency checks on an incomplete tasks.md file will surface coverage gaps by identifying requirements without tasks, but a completed tasks.md produced by speckit.tasks is required for accurate analysis.