skill-review

To audit a SKILL.md file for best-practice compliance, run a checklist-driven review that validates frontmatter, description quality, structure, and linked references. This produces a structured pass/fail report with categorized findings and prioritized remediation steps suitable for pre-publish workflows.

A structured SKILL.md quality review checks frontmatter compliance, description quality, document structure, linked references, and scripts. It loads referenced files to detect broken links and flags heavy inline content that should be relocated, assigning PASS, WARNING, or ERROR to each item.

You validate plugin and skill development workflows for broken references by running context-aware validation that loads and inspects linked reference files. This detects broken links and identifies heavy inline content that should be relocated before merging or publishing.

Yes, you can use a checklist-driven audit to score your SKILL.md and generate remediation steps. The review executes predefined checks, assigns PASS, WARNING, or ERROR statuses, and outputs a summary score with prioritized recommendations for code-review workflows.

The best way to ensure SKILL.md discoverability and quality requirements are met is to run a reproducible checklist audit before publishing to a marketplace or merging a plugin. This identifies spec violations and best-practice issues while explaining why each finding matters.

You should not use an automated SKILL.md audit when you need subjective content evaluation or semantic reasoning beyond structural validation, as the review focuses on spec compliance, frontmatter, broken references, and predefined best-practice checks rather than nuanced content quality.