spec-validation

Validate specification structure, content, cross-references, and completeness.

3|Updated Jan 18, 2026
One-click install
npx skills add https://github.com/HankLiu447/SuperSpec --skill spec-validation-hankliu447
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-validation
Source: https://github.com/HankLiu447/SuperSpec/tree/main/skills/spec-validation
Command: npx skills add https://github.com/HankLiu447/SuperSpec --skill spec-validation-hankliu447

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill ensures specifications are structurally correct, complete, and consistent, preventing drift between documentation and implementation.

Core Features & Use Cases

  • Structure Validation: checks required sections and header hierarchy to ensure specs are navigable.
  • Content Validation: enforces proper format for requirements and scenarios to avoid ambiguous language.
  • Consistency Validation: verifies cross-references, delta references, and label integrity across specs.
  • Completeness Validation: ensures every requirement has at least one scenario and no empty sections.

Quick Start

Run the validation workflow on a change or on all specs using the superspec validate command.

Frequently Asked Questions about spec-validation

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

FAQPage Schema
How do I validate specifications for structural consistency before implementation?

You can validate specifications by checking required sections, header hierarchy, and frontmatter presence to ensure specs are structurally correct, navigable, and ready for reliable builds.

What is cross-reference validation in spec documents?

Cross-reference validation verifies that delta references and label integrity match across specs, preventing drift between documentation and implementation by ensuring all linked content is consistent.

How do I check that every requirement has a scenario in my specs?

Completeness validation enforces that every requirement has at least one scenario and no empty sections exist, avoiding ambiguous language and ensuring specs are fully ready for implementation.

Do I need frontmatter in my specs to run validation?

Yes, spec validation enforces frontmatter presence, requiring both a name and description in the metadata to ensure documents are well-formed and properly identified before processing.

Can I validate deltas and changes within brainstorm and plan workflows?

Yes, the validation workflow applies directly to changes and deltas within brainstorm and plan workflows, checking structure, content, cross-references, and completeness for reliable builds.

What's the best way to run spec validation across all documents?

Running the superspec validate command allows you to execute the validation workflow on a single change or across all specs, checking structure, content, and consistency automatically.