spec-validator

Validate Spec-Driven Development artifacts across feature directories and generate a report of findings and recommendations.

1|Updated Dec 3, 2025
One-click install
npx skills add https://github.com/dan1901/spec-mix --skill spec-validator-dan1901
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-validator
Source: https://github.com/dan1901/spec-mix/tree/main/.claude/skills/spec-validator
Command: npx skills add https://github.com/dan1901/spec-mix --skill spec-validator-dan1901

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates Spec-Driven Development (SDD) artifacts to ensure they are complete, consistent, and aligned with project conventions before implementation begins, reducing rework and miscommunication.

Core Features & Use Cases

  • Artifact validation: Verifies required files exist (spec.md, plan.md, tasks.md) and are properly structured.
  • Cross-artifact checks: Ensures spec, plan, and tasks align and cover all user stories.
  • Quality feedback: Highlights gaps, ambiguities, and scope issues with actionable recommendations.

Quick Start

To validate a feature, point the validator at its specs folder, e.g., specs/001-user-auth, and run the validation.

Frequently Asked Questions about spec-validator

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

FAQPage Schema
How do I validate spec-driven development artifacts for completeness?

Spec validation checks that required files (spec.md, plan.md, tasks.md) exist and are properly structured within your feature directory. Point the validator at your specs folder—for example, specs/001-user-auth—and it produces a comprehensive report detailing missing sections, gaps, and actionable recommendations to ensure specs are complete before implementation.

What does a spec validation report include?

The validation report details findings across spec completeness, plan feasibility, and task breakdown accuracy. It checks cross-reference consistency between artifacts, verifies all user stories are covered, highlights ambiguities and scope issues, and provides recommendations to resolve gaps before development begins.

Can I validate specs, plans, and tasks together for alignment?

Yes. Spec validation performs cross-artifact checks across specs, plans, and tasks to ensure they align and cover all user stories. It enforces required files and sections, then validates that information flows consistently between artifacts without conflicts or missing coverage.

When should I run spec validation in my workflow?

Run spec validation before implementation begins. It catches completeness issues, consistency problems, and scope misalignments early, reducing rework and miscommunication. Apply it to specs, plans, and task artifacts across feature directories as part of your pre-development quality gate.

What problems does spec validation solve?

Spec validation ensures Spec-Driven Development artifacts are complete, consistent, and aligned with project conventions before coding starts. It addresses spec completeness, plan feasibility, task breakdown accuracy, and cross-reference consistency—reducing implementation delays caused by incomplete or conflicting requirements.

Do I need existing spec files to use the validator?

Yes. Spec validation requires your feature directory to contain spec.md, plan.md, and tasks.md files. It validates their structure and content; if required files are missing, the validation report highlights those gaps so you can create them before proceeding.