skill-reviewer
Reviews and improves Claude Code skills against official best practices. Supports three modes - self-review (validate your own skills), external review (evaluate others' skills), and auto-PR (fork, improve, submit). Use when checking skill quality, reviewing skill repositories, or contributing improvements to open-source skills.
90
85%
Does it follow best practices?
Impact
100%
1.33xAverage score across 3 eval scenarios
Advisory
Suggest reviewing before use
Quality
Discovery
85%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description that clearly articulates what the skill does (three review modes for Claude Code skills) and when to use it. The main weakness is trigger term coverage - while it includes some natural keywords, it could benefit from additional variations users might naturally say when seeking skill validation or improvement.
Suggestions
Add more natural trigger terms users might say, such as 'lint skill', 'validate skill.md', 'skill best practices', or 'improve my skill file'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Reviews and improves Claude Code skills', 'validate your own skills', 'evaluate others' skills', 'fork, improve, submit'. Clearly describes three distinct modes of operation. | 3 / 3 |
Completeness | Clearly answers both what ('Reviews and improves Claude Code skills against official best practices' with three modes) AND when ('Use when checking skill quality, reviewing skill repositories, or contributing improvements to open-source skills'). | 3 / 3 |
Trigger Term Quality | Includes some relevant keywords like 'skill quality', 'skill repositories', 'open-source skills', but missing common variations users might say such as 'lint skill', 'check my skill.md', 'skill validation', or 'skill best practices'. | 2 / 3 |
Distinctiveness Conflict Risk | Very specific niche focused on 'Claude Code skills' and 'skill repositories' - unlikely to conflict with general code review or documentation skills. The three modes (self-review, external review, auto-PR) create clear boundaries. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with strong actionability and clear workflows. The three-mode organization is effective, and the 'Additive Only' principle is well-documented with concrete examples. Minor verbosity in the setup section and some checklist redundancy prevent a perfect conciseness score.
Suggestions
Trim the setup section's bash comments - Claude doesn't need '# 1. Check if skill-creator exists' explanations for straightforward commands
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient but includes some redundancy (e.g., the setup section's bash comments explain obvious steps, and some workflow checklists repeat concepts). The content assumes Claude's competence in most areas but could be tighter. | 2 / 3 |
Actionability | Provides concrete, executable bash commands, specific YAML before/after examples, and copy-paste ready checklists. The three modes have clear actionable steps and the common issues section shows exact fixes. | 3 / 3 |
Workflow Clarity | Clear multi-step workflows with explicit checklists for each mode. The self-review checklist at the end serves as a validation checkpoint, and the Auto-PR workflow includes a 'respect check passed?' gate before submission. | 3 / 3 |
Progressive Disclosure | Well-structured with a quick checklist inline and clear one-level-deep references to detailed materials (evaluation_checklist.md, pr_template.md, marketplace_template.json). Content is appropriately split between overview and reference files. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- daymade/claude-code-skills
- Commit
392d34c
- Reviewed
Table of Contents
Is this your skill?
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.