skill-md-validator

To validate SKILL.md files in CI workflows, use a validator to check YAML frontmatter for required fields like name, description, and version. This ensures documentation consistency and reduces misconfiguration review overhead across repositories.

SKILL.md frontmatter validation checks YAML syntax and verifies the presence of essential metadata fields such as name, description, and version. It is needed to enforce consistent structure and meaningful content across multiple documentation repository entries.

Yes, you can check all SKILL.md files by looping through the repository directories. The validator verifies substantive content exists after the frontmatter and requires headings to aid readability across all entries.

Yes, the SKILL.md validator checks YAML syntax to ensure proper frontmatter formatting and verifies that the Markdown content contains non-trivial text with appropriate headers for readability.

The best way to enforce SKILL.md quality during pull requests is integrating a validation script into CI/CD pipelines. This automates frontmatter field checks and content structure verification for every submitted file.