skill-quality-reviewer

Analyze skill directories and generate weighted quality reports and improvement plans.

Updated Aug 27, 2026

Search Tags:#documentation #writing-style #quality-review #skill-quality #skill-audit #structural-integrity

Ready to run

npx skills add https://github.com/AnXueHua/auto-research --skill skill-quality-reviewer-anxuehua

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: skill-quality-reviewer
Source: https://github.com/AnXueHua/auto-research/tree/main/skills/skill-quality-reviewer
Command: npx skills add https://github.com/AnXueHua/auto-research --skill skill-quality-reviewer-anxuehua

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill provides an objective, rubric-driven assessment of Claude Skills to identify weaknesses in discoverability, documentation, organization, writing style, and structural completeness that block safe sharing and reuse.

Core Features & Use Cases

Weighted scoring: Computes dimensioned scores and a composite grade across description quality, content organization, writing style, and structural integrity.
Validation and parsing: Extracts and validates SKILL.md YAML frontmatter, verifies referenced files, and inspects scripts for basic errors.
Reports and remediation: Produces a detailed quality report and a prioritized improvement plan with suggested edits and estimated impact.
Use Case: Run before publishing a skill to catch broken references, style issues, missing frontmatter fields, and organization problems.

Quick Start

Analyze the skill at ./my-skill to produce quality-report-my-skill.md and improvement-plan-my-skill.md.

Frequently Asked Questions about skill-quality-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I audit Claude skill quality before publishing?▼

You audit Claude skill quality by parsing SKILL.md frontmatter, validating referenced files and scripts, computing weighted scores across description, organization, style, and structure, and outputting a quality report with an improvement plan.

What does a skill quality review include?▼

A skill quality review includes weighted scoring across description quality, content organization, writing style, and structural integrity, along with validation of SKILL.md YAML frontmatter and referenced scripts to produce a remediation plan.

How do I check SKILL.md frontmatter for missing fields?▼

You check SKILL.md frontmatter for missing fields by extracting and validating the YAML frontmatter against required metadata fields, verifying referenced files, and inspecting scripts for basic errors to ensure structural completeness.

How do I fix broken file references in a skill package?▼

You fix broken file references in a skill package by running a structural integrity check that validates referenced files against the skill directory, identifies missing paths, and generates a prioritized improvement plan with suggested edits.

Can I score writing style and documentation organization automatically?▼

Yes, you can score writing style and documentation organization automatically by applying a rubric-driven assessment that computes dimensioned scores for content organization and writing style, then generates a composite grade with actionable feedback.

What is the best way to review skill directories for safe sharing?▼

The best way to review skill directories for safe sharing is to perform a pre-publication audit that assesses discoverability, documentation, organization, style, and structural completeness to identify weaknesses that block safe reuse.