design-validate

Validate design documents against the SDD standard for frontmatter, naming, and required sections.

Updated Apr 2, 2026
One-click install
npx skills add https://github.com/oogDZ/2 --skill design-validate-oogdz
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: design-validate
Source: https://github.com/oogDZ/2/tree/main/.claude/skills/design-validate
Command: npx skills add https://github.com/oogDZ/2 --skill design-validate-oogdz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill validates design documents (project specifications) against the SDD standard, ensuring frontmatter presence, proper naming, and required sections so design intent stays aligned with implementation.

Core Features & Use Cases

  • Enforces frontmatter correctness (name and description) and alignment with the SDD standard.
  • Verifies required sections including SVC-N with nine subsections, INT-N, STS-N, delta-format, markers, and defined zones of responsibility.
  • Supports use during design creation, peer reviews, and pre-commit checks to guarantee consistent, high-quality documentation.

Quick Start

Run /design-validate path/to/design.md to verify conformance against the standard.

Frequently Asked Questions about design-validate

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

FAQPage Schema
How do I validate design documents against the SDD standard?

To validate design documents against the SDD standard, run the validation tool on your markdown file to enforce frontmatter presence, proper naming, and required sections. This ensures design intent stays aligned with implementation.

What sections are required in an SDD compliant design doc?

Required sections in an SDD compliant design doc include SVC-N with nine subsections, INT-N, STS-N, delta-format, markers, and defined zones of responsibility. Frontmatter must also contain correct name and description fields.

Can I use a markdown validation tool for pre-commit checks?

Yes, you can use this markdown validation tool for pre-commit checks to guarantee consistent, high-quality documentation. It supports use during design creation and peer reviews to enforce SDD standards compliance.

What is the best way to enforce frontmatter and naming conventions in design docs?

The best way to enforce frontmatter and naming conventions is using an automated validation tool that checks for correct name and description fields. This ensures alignment with the SDD standard during design creation.

Why does my design doc fail validation for SVC-N subsections?

Design docs fail validation for SVC-N subsections when the 8:8 mapping is incomplete or incorrect. The validator enforces nine subsections within SVC-N to ensure strict compliance with the SDD standard.