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.