skill-health-check

Validate YAML frontmatter in skill definition files by running a structural lint check that ensures required fields like name, source, triggers, and description exist before they break builds.

Linting skill.md files for structural issues involves checking YAML frontmatter, enforcing a 250-line count limit, and verifying coordination metadata to prevent broken pipelines and failed CI checks.

You need a Ruby environment to parse YAML when checking skill file structure, but the validation can be executed via provided shell commands without requiring any external dependencies.

Check coordination metadata in a skills directory by validating that required keys like group, order, and internal exist within the YAML frontmatter of all skill.md files.

CI pipelines fail after bulk changes to skill files when structural issues like missing frontmatter fields, line-count violations over 250 lines, or missing Failure Modes sections go unnoticed.

You can detect missing Failure Modes sections in skill definition files by running a structural lint check that alerts when the required section is absent from the skill.md document.