skill-stocktake

To audit your GitHub skills repository, scan the .github/skills/ directory to detect missing SKILL.md files and generate a health report covering quality, coverage, and staleness across your skill inventory.

YAML frontmatter validation is the process of verifying required fields exist in skill files, flagging mismatches like hint: versus argument-hint:, and detecting autopilot naming collisions to maintain repository quality.

Check for template synchronization gaps by diffing .github/skills/ against vscode-omg/resources/templates/skills/ to identify orphaned files in either direction and ensure your library stays aligned.

Yes, you can cross-check coverage by comparing skills referenced in .github/copilot-instructions.md against actual directories on disk to find gaps where documented skills are missing from the repository.

Run a skill inventory maintenance routine during pre-merge validation before adding new skills, post-batch template synchronization after changes, and periodically to remove incomplete or outdated entries from your repository.

When auditing GitHub skills, look for mismatched name fields, weak descriptions, missing When to Use or Output Format sections, broken cross-references, and stubby files to calculate an overall quality score.