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.