About pr-review
pr-review is a skill for conducting evidence-based reviews of GitHub pull requests. It defines a staged process for reviewing changes, handling prior findings and follow-ups, and requesting approval before publishing a review.
Key features
- 01Pin the PR head revision
- 02Load diffs and review threads
- 03Delegate review work to tasks
- 04Apply review standards and checks
- 05Request approval before publishing
Use cases
- 01Review a pull request with no prior findings
- 02Assess follow-up changes against earlier findings
- 03Run a full rescan when scope expands
- 04Prepare a review for approval before posting
Install
Copy the command and run it in a terminal.
npx skills add https:/ / github.com/ gabriel-lafrance/ skills --skill pr-reviewAfter installing, type/pr-reviewin Claude Code to confirm it loaded.
Bundled filesdoctrine.mdreference.md
Details
From the project READMEPR Review
Must read: ../pack-shared/standards.md. Apply the Taste and Architecture sections of AGENTS.md this turn before adjudicating Standards. Do not skip.
Ask style: ../pack-shared/asking.md
This skill is a user start. Do not nest it under /task.
Read doctrine.md and reference.md. The shared review contract owns review depth, evidence, the review output fence, finding records, and severity mapping. The shared execution context owns stateless authority and handoff rules.
Standards: always apply the Taste and Architecture sections of AGENTS.md this turn. Apply
code-review:blocker-vs-follow-up, code-review:naming-alignment, the
Correctness hunt, and pr-review:* extras on initial and full-rescan (and on
newly introduced follow-up surface). Do not run a Design axis.
Process
- Pin the PR fixed point (
headSha) and load its body, commits, diff, all inline review comments, and all review threads, including resolved threads and every prior review page. RecordpreviousReviewedHeadfrom the last review this skill completed on this PR when available (from chat or the latest review commit association). - Dispatch
pr-reviewerTasks per ../pack-shared/subagents.md. Feed the what (open GitHub PR, injected plan, bars). The worker owns how to hunt. The parent reviews Completions and owns the publish question. Do not solo non-trivial PR review labor. - With no prior finding thread, run the shared contract's
initialreview. - On every follow-up, complete Pass A first (doctrine Output), then Pass B.
- Use
full-rescanonly when the user explicitly requests it or materially expands the review scope. - Show drafts, ask one publish question, apply the stale-head guard, then post only after approval.