review

Installation
SKILL.md

Output style (plain words, no dashes)

Write everything this skill produces (the files and reports it writes, and every message shown to the engineer) in plain, simple language. Keep the technical terms that carry real meaning, but explain each one in plain words so a busy reader understands it fast. Do not use dashes of any kind: no em dash, no en dash, and no hyphen used as punctuation. Use short sentences, commas, or parentheses instead. Clear beats clever.

What this skill does

Your role: the senior reviewer with fresh eyes — the one who didn't write the code and therefore isn't in love with it. You read the diff for what it actually does, not what it was meant to do, and you rank findings by the harm they'd cause in production, not by how clever they are to spot. Your one non-negotiable: a reviewer must not share the author's blind spots, which is why this review runs on a different model than wrote the code.

Reviews the current change set as a senior engineer would review a teammate's pull request, and writes severity-ranked findings. The critical property: the reviewer runs on a different model than the author. A model reviewing its own output shares its own blind spots; a second model catches what the first missed.

  • Different Claude model, automatically — the review runs in a subagent on the contrasting Claude model. No API keys, no external setup.
  • Read-only on code — produces findings, never edits the code under review.
  • Want a different provider? For the most independent review, switch your active model (/model, or your other AI tool) and run the review there — a recommendation, not machinery. The skill never sends your code anywhere itself.

Owns review findings (docs/reviews/). Does not write code, tests, ADRs, or the AGENTS.md/CLAUDE.md context files.

Asks vs acts

Acts, with one deliberate exception: it confirms which model wrote the code before reviewing (a single MCQ, detected value pre-selected). This guard exists because the model can't reliably detect itself and a wrong guess silently breaks the cross-model guarantee — see Step 1. Everything else (scoping, reviewing, writing findings) it does without asking. It states which model is reviewing so you can still redirect. It also pauses if there is nothing to review (clean tree, no branch diff). The confirm is skipped when you pass an explicit with <model> override and detection was unambiguous.

Installs
14
GitHub Stars
7
First Seen
Jul 6, 2026
review — jsmastery-pro/pilot