discussion-validate

Validate discussion documents against SDD frontmatter and sectioning rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It ensures that discussion documents adhere to the SDD standard by verifying frontmatter presence, proper naming, section structure, numbering, markers, and ownership attribution.

Core Features & Use Cases

  • Frontmatter conformance: checks for required fields like name and description.
  • Section integrity: validates section order, numbering, and markers for consistency.
  • Review workflow integration: aids code reviews and pre-commit checks by flagging deviations.

Quick Start

Run /discussion-validate specs/analysis/0001-oauth2/discussion.md to validate a discussion document against the standard.

Frequently Asked Questions about discussion-validate

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

FAQPage Schema
How do I validate discussion documents against SDD frontmatter and sectioning standards?▼

To validate discussion documents, run the validation command on a specific file path. It identifies and reports deviations from SDD frontmatter, section order, numbering, markers, and ownership rules, providing a structured JSON report when requested.

What does SDD frontmatter conformance checking look for in a discussion document?▼

SDD frontmatter conformance checking verifies the presence of required fields like name and description. It ensures the discussion document adheres to the standard frontmatter rules before proceeding to validate section integrity and ownership attribution.

Can I validate all discussion documents at once or do I need to check individual files?▼

You can apply the validation to individual files or to all discussions at once. Running the command on a specific file path validates that document, while batch processing flags deviations across the entire discussion directory.

How do I integrate discussion document validation into a code review workflow?▼

To integrate discussion document validation into a code review workflow, use it for pre-commit checks to automatically flag deviations from SDD standards. This ensures frontmatter, section order, and numbering rules are enforced before changes are merged.

Does the discussion validator report section order and numbering deviations?▼

Yes, the discussion validator reports section order and numbering deviations. It enforces section structure and markers for consistency, ensuring the document meets the SDD sectioning rules and providing a structured report of any inconsistencies found.