Skill Reviewer
A quality gate for Claude Code skills: audits your own or others' skills against official best practices and can even open an improvement PR.
Dev & CodingIntermediate★ 1,323⑂ 212AI score 9/10Last updated: Aug 8, 2026
What it does
- Runs an automated review of a Claude Code skill against official best practices: frontmatter (name/description), third-person phrasing, presence of trigger conditions, SKILL.md size (under 500 lines), directory layout, hardcoded paths and secrets, script error handling, and
subagent_typevalidity. - Offers three modes: self-review (before publishing), external review (evaluate someone else's repo and produce an improvement report), and auto-PR (fork, improve, submit).
- Uses clear exit codes: 0 = clean, 1 = warnings only, 2 = review errors, 3 = the reviewer itself failed.
- Enforces an additive-only contribution philosophy: never delete files, remove features, or switch the original language — plus respectful PR wording templates and required PR sections.
Who it's for
- Skill authors who want a quality check before publishing to a marketplace or GitHub
- Maintainers of multi-skill repositories
- Contributors who want to send polite, well-justified PRs to open-source skills
Examples
- Pre-release check: "Review my
pdf-helperskill" → flags a first-person description with no trigger conditions and proposes a rewritten line. - External audit: give it a GitHub skill repo; it clones to
/tmp, reads all docs, and produces a checklist-based improvement report. - Automated contribution: forks the repo, creates a branch, applies additive-only improvements, and drafts a PR with Summary / What's NOT Changed / Rationale / Test Plan.
· · · Install guide · · ·
Install in the Claude app (no terminal)
- Download the ZIP with the button below.
- In Claude, open Settings → Capabilities and turn on 'Code execution and file creation'. (one time)
- Go to Customize → Skills → + → 'Upload a skill' and upload the ZIP.
Install in Claude Code
Let Claude do it — paste this into Claude Code
Install the skill I found on Claude Skill Mart. Copy the daymade-skill/skill-reviewer folder from the GitHub repo daymade/claude-code-skills into my ~/.claude/skills/skill-reviewer/. When it's done, tell me in one line what this skill can do.
Install with a command instead
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills && mkdir -p ~/.claude/skills && cp -r /tmp/claude-code-skills/daymade-skill/skill-reviewer ~/.claude/skills/⚠ This is a third-party skill. Check the source repository before installing.
- Install
uv, which the review script needs:curl -LsSf https://astral.sh/uv/install.sh | sh - Clone the repository:
git clone https://github.com/daymade/claude-code-skills.git /tmp/claude-code-skills - Create the skills folder if needed:
mkdir -p ~/.claude/skills - Copy this skill:
cp -r /tmp/claude-code-skills/daymade-skill/skill-reviewer ~/.claude/skills/ - Also copy the sibling skill it relies on for deeper security scans:
cp -r /tmp/claude-code-skills/daymade-skill/skill-creator ~/.claude/skills/ - Restart Claude Code and ask: "Use skill-reviewer to review ~/.claude/skills/<skill-name>"
- Read the outcome by exit code: 0 clean, 1 warnings, 2 errors, 3 the reviewer could not run (check your
uvinstall).
View source on GitHub ↗License: MIT