git404hub

what is skill-reviewer fr?

terryc21/skill-reviewer — explained in plain English

Analysis updated 2026-05-18

19Audience · developerComplexity · 2/5Setup · easy

tl;dr

A Claude Code skill that reviews other Claude Code skills, producing a sorted report of strengths, finding cards with file and line citations, and severity ratings.

vibe map

mindmap
  root((skill-reviewer))
    Inputs
      Skill directory path
      Optional lens flag
      Second-opinion flag
    Outputs
      Markdown report
      Finding cards
      Patterns section
    Use Cases
      Audit a skill pre-publish
      Review a teammate skill
      Get a second opinion
    Tech Stack
      Claude Code
      Markdown
      Plugin marketplace

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Run a full review of your skill folder before publishing it

VIBE 2

Get a five-minute summary verdict on a skill you maintain

VIBE 3

Focus a review on safety or another lens with the --lens flag

VIBE 4

Add a challenger pass with --second-opinion to push back on the verdict

what's the stack?

Claude CodeMarkdown

how it stacks up fr

terryc21/skill-reviewer16nic/comfyui-agnes-ai521xueweihan/hgdoll
Stars191919
LanguagePythonKotlin
Setup difficultyeasymoderatehard
Complexity2/52/54/5
Audiencedevelopervibe coderdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · easy time til it works · 5min

Two plugin marketplace install commands have to be run one at a time, and there is no tab-complete for the subcommands.

in plain english

skill-reviewer is itself a Claude Code skill, and its job is to review other Claude Code skills. A skill, in this setting, is a folder with a markdown file and supporting files that tells Claude how to do a particular task. The README opens with a complaint: when you ask a friend to look at a skill you have written, you usually get a polite answer like, looks great, maybe add some tests. The author calls that a hug, not a review. skill-reviewer is meant to read every file in your skill, cite specific lines, separate strengths from weaknesses, and rate findings by severity instead of hedging. Using it inside Claude Code is straightforward. There are two install commands, both for the /plugin marketplace, that have to be run one at a time. After that, /skill-reviewer is available in any session. The simplest invocation is /skill-reviewer review followed by the path to a skill directory. After two to five minutes, you get a markdown report with a short TL,DR, five to ten strengths to keep, a sorted stack of finding cards (each one with a Why, a Fix, a file and line citation, an effort estimate, and a quick-win tag), and a Patterns section that names themes that cross several findings. For a lighter pass there is also /skill-reviewer summary, which takes about five minutes and returns the headline verdict with three to five strengths and up to five finding cards. The README lists a few other ways to scope a run. You can pass --lens=safety, or another lens, to focus the review on one concern. You can pass --second-opinion to add a challenger pass that pushes back on the first verdict, which the author recommends before publishing. There is also a /skill-reviewer detect command that just classifies the shape of a skill and a /skill-reviewer lenses command that lists the available lenses. A manual install path exists for users who cannot use the plugin marketplace, in which case the invocation becomes /skill skill-reviewer followed by the same arguments. The README is honest about a few details. There is no per-subcommand autocomplete, so tab-complete after /skill-reviewer will not list review, summary, and so on. Every review is a fresh read of the files at the given path, the skill does not auto-load older reports, although prior reports are kept in a .agents/research/ folder for manual reference. The author also notes that the project self-reviews after every meaningful edit, and is at version 0.3.1 with five releases in the 0.x line. The project is positioned for moments before publishing a skill, when auditing someone else's skill, before merging a large pull request to a skill, or when you suspect your own internal review has been either too kind or too harsh.

prompts (copy fr)

prompt 1
Install skill-reviewer from the Claude Code plugin marketplace and run it on my skill folder
prompt 2
Run /skill-reviewer review with --lens=safety on my new skill and act on the high-severity findings
prompt 3
Use /skill-reviewer summary to get a quick verdict before I open a PR
prompt 4
Add --second-opinion and reconcile the two verdicts in a single notes file
prompt 5
Write a new lens for skill-reviewer that focuses on prompt-injection risk

Frequently asked questions

what is skill-reviewer fr?

A Claude Code skill that reviews other Claude Code skills, producing a sorted report of strengths, finding cards with file and line citations, and severity ratings.

How hard is skill-reviewer to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is skill-reviewer for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.