skill-auditor

To validate skill definitions for quality, run an audit script against your skills directory to check frontmatter fields, section presence, and placeholder avoidance. This generates a structured report with actionable recommendations and decomposition guidance.

A skill definition audit checks for required frontmatter fields like name and description, verifies key sections such as When to Use and Workflow are present, and flags gaps or placeholders to ensure adherence to project conventions.

To generate machine-readable audit reports for skill validation, run the audit script with the JSON flag against your skills directory. This outputs structured validation results capturing frontmatter errors and structural gaps for automated processing.

Yes, you can audit skill frontmatter and structure across a full repository by pointing the audit script to your skills directory. It evaluates all skill definitions, enforcing required fields and section presence while offering decomposition recommendations.

You need to audit skill definitions for convention adherence when managing a repository of skills to ensure consistent frontmatter, complete structural sections, and proper quality standards before deployment or team collaboration.

Automated skill definition validation is limited to structural and frontmatter checks, enforcing required fields and section presence, but cannot assess semantic quality or contextual appropriateness of the skill content itself.