skill-quality-reviewer

To evaluate a Claude Skill, load its SKILL.md file to extract and validate the YAML frontmatter, then compute weighted dimension scores for description, organization, style, and structure to generate a standardized quality report.

Auditing documentation quality in a local skills repository involves analyzing the YAML frontmatter and structural integrity of each SKILL.md file, producing both a comprehensive quality report and a targeted improvement plan.

The weighted scoring system evaluates skill quality by assigning percentage weights to four dimensions: Description (25%), Organization (30%), Style (20%), and Structure (25%), calculating a final standardized grade.

Yes, generating an improvement plan maps identified issues to exact file locations within your skill directory, such as SKILL.md, references/, and scripts/, and suggests concrete edits to resolve them.

You need to provide the local directory path to the skill you want to assess, such as ./skills/skill-name, so the tool can load the SKILL.md file and validate its YAML frontmatter.

Evaluating skills without valid YAML frontmatter limits the assessment because the tool relies on extracting the name and description fields from the YAML to compute the description quality score.