validate-skill-docs

Validate SKILL.md frontmatter alignment with skills-meta.ts and docs/skills.

6|Updated Mar 4, 2026
One-click install
npx skills add https://github.com/rnagrodzki/sdlc-marketplace --skill validate-skill-docs
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: validate-skill-docs
Source: https://github.com/rnagrodzki/sdlc-marketplace/tree/main/.claude/skills/validate-skill-docs
Command: npx skills add https://github.com/rnagrodzki/sdlc-marketplace --skill validate-skill-docs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This validation Skill ensures content consistency between SKILL.md frontmatter, the skills-meta.ts data file, and the documentation surfaces (docs/skills and site data). It prevents drift after modifications to skill workflows, flags, or documentation templates.

Core Features & Use Cases

  • Validates user-invocable alignment between SKILL.md frontmatter and skills-meta.ts entries.
  • Checks that required documentation sections exist in docs/skills and that flag documentation mirrors argument-hint flags.
  • Generates structured findings (errors and warnings) to guide quick fixes and maintain documentation integrity.

Quick Start

Run the validation script to verify consistency across SKILL.md, docs/skills, and skills-meta.ts.

Frequently Asked Questions about validate-skill-docs

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

FAQPage Schema
How do I check that SKILL.md frontmatter is aligned with skills-meta.ts?▼

To check frontmatter alignment with skills-meta.ts, run a validation script that parses both files to verify user-invocable entries match across metadata surfaces, producing actionable errors and warnings to fix drift.

What is the best way to prevent documentation drift after modifying skill workflows?▼

To prevent documentation drift after skill workflow modifications, validate consistency across SKILL.md frontmatter, skills-meta.ts, and docs/skills. This ensures flag documentation mirrors argument-hints and required documentation sections remain intact.

How do I validate that docs/skills template coverage includes required sections?▼

To validate docs/skills template coverage, run the validation script to check that required documentation sections exist in docs/skills. It parses the documentation surfaces and flags missing sections with structured warnings for quick fixes.

Can I use automated validation to enforce consistency across SKILL.md and site data?▼

Yes, automated validation enforces strict consistency by parsing SKILL.md frontmatter, skills-meta.ts, and docs/skills. It checks slug connections and produces structured findings to maintain documentation integrity across all skills.

Why does my skills-meta.ts entry show errors when frontmatter flags are updated?▼

Errors occur when skills-meta.ts entries drift from updated SKILL.md frontmatter flags. The validation script checks that flag documentation mirrors argument-hint flags and reports misaligned user-invocable entries as actionable findings.