reviewing-agent-skill

You can validate YAML frontmatter by running automated mechanical checks that detect metadata presence, enforce name and description constraints, and verify body length. This ensures your SKILL.md file adheres to authoring best practices and produces a clear PASS or NEEDS_WORK verdict.

The best way to review a SKILL.md file is to perform mechanical checks for YAML frontmatter, path hygiene, and structure, followed by content-quality evaluation. This generates a summary with issues and suggestions to improve skill discoverability and trigger reliability.

To check SKILL.md metadata and structure during a PR review, apply a validation script that checks frontmatter, name constraints, description tone, and body length. The review yields actionable suggestions and a NEEDS_WORK or PASS verdict for re-validation.

Common frontmatter errors that cause SKILL.md validation to fail include missing YAML frontmatter, violating name and description constraints, exceeding body length limits, and poor path hygiene. The validation script identifies these mechanical issues for correction.

Yes, you can use automated linting to improve SKILL.md content quality by validating metadata, structure, and script usage. The review process checks description tone and path sanitation, offering structural and workflow recommendations to enhance clarity.