skill-review

Skill Review performs a 9-phase audit of claude-skills documentation to detect YAML frontmatter violations, keyword coverage gaps, version drift, broken links, and code example accuracy. Run the audit script against your target skill to identify issues, classify severity, and receive automated fixes for unambiguous problems.

YAML frontmatter validation verifies the metadata block at the top of skill files for structural correctness, required field presence, and keyword alignment with official documentation standards. The audit flags missing or malformed fields and cross-references them against the official docs.

Yes. Skill Review auto-fixes unambiguous inconsistencies like formatting errors and version updates across multiple files, then generates a changelog. You review the proposed fixes before applying updates to maintain control over changes.

Skill Review compares declared package versions in skill documentation against current versions in package managers and GitHub repositories. It flags outdated or mismatched versions and suggests updates to align documentation with actual dependency currency.

Cross-file consistency checks verify that skill descriptions, examples, and metadata align across README, frontmatter, and code files. The audit identifies contradictions between files and suggests standardized rewrites to eliminate drift.