skill-validator

To validate SKILL.md frontmatter and directory structure, you can run the skill validator on a specific path to detect missing YAML fields, check directory conventions, and ensure unique skill names across the repository.

YAML frontmatter validation checks for the presence and correctness of required name and description fields in SKILL.md files, ensuring skill directories conform to repository standards and preventing broken skills.

To resolve internal references in SKILL.md, run the validator to automatically verify that all linked paths point to existing files within the skill directory, preventing broken references.

Yes, you can check an entire repository for duplicate skill names by running the skill validator across the full skill set, enforcing unique names and reporting structural issues globally.

The best way to enforce repository quality is to automate validation of frontmatter correctness, reference resolution, and directory conventions across all skill directories to prevent structural issues.

Skill validation fails when directory conventions are not followed, such as missing required frontmatter fields in SKILL.md, unresolved internal file references, or duplicate skill names within the repository.