verify-skill-format

To validate YAML frontmatter, scan all skill directories to ensure each contains proper delimiters with required name and description fields. This metadata validation prevents discovery and execution issues caused by incomplete skill definitions.

Skill directory names must match frontmatter names to enforce naming consistency across the catalog. Mismatched names cause discovery failures, making skills unfindable or unexecutable during runtime operations.

Checking for missing required fields involves scanning skill directories to verify the presence of name and description in YAML frontmatter. The validator reports these violations alongside mismatched names with suggested fixes.

You can ensure skill names are unique by running a catalog-wide uniqueness check that scans all skill directories. This prevents duplicate naming conflicts and maintains a consistent, reliable skill registry.

The best way to fix frontmatter consistency errors is to run a validator that returns a structured list of violations with suggested fixes. This guides remediation for missing fields, invalid delimiters, or mismatched directory names.

The skill format validator applies to all skill units under the dotfiles/skills/** directory path. It scans this specific structure to report frontmatter or naming issues across the entire skill catalog.