Skill

skill-review

Reviews SKILL.md files against best practices with structured pass/fail reports, warnings, errors, and prioritized recommendations before publishing or deploying.

code-quality

npx claudepluginhub hamsurang/kit --plugin skill-review

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Reviews a `SKILL.md` against established best practices and outputs a structured pass/fail report with prioritized recommendations.

Supporting Assets

references/checklist.md

SKILL.md

Similar Skills

skill-check

36.4k

Validates SKILL.md files against agentskills spec and best practices. Catches structural, semantic, naming, and quality issues; provides scores, grades, and fix suggestions before publishing or debugging.

1 tool

antigravity-awesome-skills

skill-lint

167

Audits Claude Code skills for compliance with SKILL-DEV-GUIDE.md: verifies directory structure, frontmatter format, line limits, flat subdirs, doc consistency, redundancy, configs, security basics, outputs, workflows, generating structured reports.

3 files

legal-skills

applying-brand-guidelines

41.6k

Applies Acme Corporation brand guidelines including colors, fonts, layouts, and messaging to generated PowerPoint, Excel, and PDF documents.

3 files

anthropics-claude-cookbooks

Stats

Parent Repo Stars16

Parent Repo Forks0

Last CommitMar 2, 2026

Actions

View Source View Plugin View on GitHub View README

Help us improve

Share bugs, ideas, or general feedback.

Skill Review

Reviews a SKILL.md against established best practices and outputs a structured pass/fail report with prioritized recommendations.

Contents

Locating the Target Skill

With explicit path: Use the provided path directly (supports both SKILL.md files and plugin directories).

Without path — search in this order:

Current directory: ./SKILL.md

Plugin skill dirs: ./plugins/*/skills/*/SKILL.md

Prompt the user if multiple matches found

Review Workflow

Read SKILL.md and any files in references/ that it links to

Run each check in references/checklist.md — assign PASS ✅, WARNING ⚠️, or ERROR ❌

Output the structured report below

Be educational, not just a linter — include a brief explanation of why each finding matters.

Output Format

## Skill Review: [skill-name] ### Summary **Status:** PASS / NEEDS WORK / FAIL **Score:** N/N checks passed | N warnings | N errors ### ✅ Passed (N) - [Check description] - ... ### ⚠️ Warnings (N) - **[Check name]**: [finding] — [brief explanation of why it matters] - ... ### ❌ Errors (N) - **[Check name]**: [finding] — [why it must be fixed before publishing] - ... ### 📋 Prioritized Recommendations 1. [Most critical fix first] 2. ...

Severity Definitions

Severity

Meaning

❌ Error

Violates a spec requirement. Must fix before publishing.

⚠️ Warning

Best practice violation. Should fix for quality.

✅ Pass

Meets the standard.

Full Rubric

See references/checklist.md for all checks organized by category (frontmatter, description quality, naming, content, structure, scripts, plugin manifest).