skill-reviewer

To validate SKILL.md files for AI skill compliance, use an automated reviewer to check YAML frontmatter for mandatory fields like name and description, and verify content against established best practices, generating a detailed checklist report with compliance status and actionable suggestions.

The required frontmatter fields for an AI skill definition are mandatory name and description attributes within the YAML frontmatter. Validating these fields ensures proper skill identification and documentation before repository integration.

Automate AI skill review before merging by running a validation tool against SKILL.md files to generate a detailed checklist report, highlighting compliance issues, severity levels, and actionable suggestions for frontmatter and content quality that need addressing in the pull request.

Yes, AI skill validation checks both naming conventions and content quality. It reviews SKILL.md files against hard rules for frontmatter requirements and best-practice rules for clarity and conciseness, ensuring comprehensive documentation compliance for developers and maintainers.

A SKILL.md compliance report includes a detailed checklist of validation results, compliance status, severity levels, and actionable suggestions for both frontmatter and content quality, helping developers identify and resolve AI skill integrity issues within the repository.

You should run an AI skill validation check before merging a new AI skill into the repository, ensuring adherence to naming conventions, frontmatter requirements, and best practices, catching any issues that need to be addressed in the pull request early.