skill-metadata-check_skill

Overview

This skill scans skill content files for YAML frontmatter issues to prevent metadata problems from breaking skill loading. It validates the presence and parseability of frontmatter and ensures required fields exist with correct types. Results point to files needing fixes so maintainers can repair metadata quickly.

How this skill works

The tool walks a skill directory and inspects each file that contains YAML frontmatter. It checks for frontmatter delimiters, attempts to parse the YAML, and verifies presence and string type for the required name and description fields. The script prints a concise status per file indicating parse success and field completeness.

When to use it

• Before publishing or deploying skill bundles
• As part of a CI pipeline to catch metadata regressions
• When onboarding new skills to ensure consistent metadata
• After bulk edits or automated refactors that may affect frontmatter

Best practices

• Run the checker from the skill root so all files are discovered
• Fix any file marked as missing or fail before merging changes
• Keep name and description concise and human-readable strings
• Integrate the script into pre-commit hooks or CI jobs for early feedback
• Use consistent frontmatter delimiters and YAML linting to reduce false positives

Example use cases

• Validate all skill content files in a codebase prior to release
• Automate metadata checks in continuous integration to prevent load-time errors
• Audit a collection of skills after a bulk content migration to find broken frontmatter
• Train new contributors by showing which files need a name and description