review-pr
Skill48 starsChanged 3 days agoApache-2.0View on GitHub
Use when reviewing a pull request — a first read, a re-check after the author pushes, or deciding whether it is ready to merge.
185 other projects use a version of this.
Adopted by
Most recently taken up by
- torrust/torrust-trackertheir own version, first seen Nov 16, 2026
- Wendor/teapod-streamtheir own version, first seen Nov 16, 2026
- testcontainers/testcontainers-javatheir own version, first seen Nov 16, 2026
- hotcodepush-team/skillstheir own version, first seen Nov 16, 2026
- chuckplayer/claude-agent-packtheir own version, first seen Nov 16, 2026
- ayoubben18/ab-methodtheir own version, first seen Nov 15, 2026
Used with
Projects with it also use diagnose-ci-failures, review-delta and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
zerx-labSkilldiagnose-ci-failures
Diagnose CI failures for a PR using the GitHub CLI, extract error logs, and generate a plan to fix them. Use when the user asks to check CI status, pull CI issues, triage test failures, or investigate PR build failures.
Also in 3 projects that use this
n24q02mSkillreview-delta
Review only changes since last commit using impact analysis. Token-efficient delta review with automatic blast-radius detection.
Also in 3 projects that use this
GeiserXSkilldocs-loop
Use when the user asks to audit docs, check documentation for stale claims, or verify docs against the code.
Also in 3 projects that use this
GeiserXSkillfull-loop
Drive a repository to done with sergio-loop, then keep improving it with refine-loop at a descending theta. Use only when the user explicitly invokes full-loop.
Also in 3 projects that use this
n24q02mSkillbuild-graph
Build or update the code review knowledge graph. Run this first to initialize, or let hooks keep it updated automatically.
Also in 3 projects that use this
- +7 more from GeiserX
Other versions185 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 185
- denoland/deno★ 109ksame name
- ToolJet/ToolJet★ 41ksame name
- remix-run/remix★ 33ksame name
- tirth8205/code-review-graph★ 33ksame name
- alpinejs/alpine★ 32ksame name
- nrwl/nx★ 29ksame name
- PrefectHQ/fastmcp★ 29ksame name
- jlowin/fastmcp★ 29ksame name
- livewire/livewire★ 24ksame name
- microsoft/fluentui★ 20ksame name
175 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- amend-adrSkill
- code-review-and-qualitySkill
- credential-incidentSkill
- file-issueSkill
- prove-event-workflowSkill
- releaseSkill
- review-fixSkill
- security-and-hardeningSkill
- security-reviewSkill
- visual-pr-shotsSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
14 rules. 0 are common, 12 are distinctive, and 2 are very specific to this project.
0
Common
Most of the 178 edited versions we read keep these.
12
Distinctive
This author's own choices. Worth a look.
2
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- could be automatic: a setting could enforce it
- Very specific: line 20
Read the code against code-review-and-quality (.claude/skills/, vendored verbatim): its five axes, its tests-first order, and its severity …
- Distinctive: line 34
Read every check, not a filtered list: a required check that never ran looks the same as a green one in a summary.
- Distinctive: line 49
The issue: Read its newest comments. A decision taken there, or in a comment, may already change what the PR should do.
- Distinctive: line 65
Grep the unchanged tree: When a PR renames something, flips a policy or corrects a premise, search the whole repository for the old name or …
- Distinctive: line 69
Run it: when reading can't settle it.
- Very specific: line 73
Never for a community PR: its code runs only in CI, after the operator approves the run (ADR-0069 item 5).
- Distinctive: line 75
Open the screenshots and recordings: Look at them; don't trust the description.
- Distinctive: line 78
Read the code a claim depends on: before you assert a race, an ordering or a library behaviour.
- Distinctive: line 80
Cite only what you read: Every file:line, ID and link in the review must come from something you opened in this review.
- Distinctive: line 104
Check this from the platform's merge state, not by reading the base SHA.
- Distinctive: line 105
No operator decision is pending, and no required security pass is missing.
- Distinctive: line 108
When everything holds except a decision only the operator can make, approve it pending: say the code is done and name the open question.
- Distinctive: line 122
Read only that interdiff, plus the body and the thread again (step 2).
- Distinctive: line 131
Read their findings before you approve.
“Common” is measured: kept by at least 6 in 10 of the 178 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
/review-pr — reviewing a pull request
A review answers one question: can this PR land as it stands, and if not, what exactly must change. This skill is the procedure. The project's rules (commit shape, what needs a test, a decision record or a doc update, who may ask for the merge) live in its conventions; read them first and review against them. This skill states the review policy; it doesn't set it.
What to look for
Read the code against code-review-and-quality (.claude/skills/, vendored
verbatim): its five axes, its tests-first order, and its severity labels.
This skill is the procedure around that read: which rounds, which gates,
where the findings go, and when to approve. Where the two disagree, the end
of this skill says which wins.
Why this exists
Each failure below was a real approval that should not have been. The diff looked right every time; the defect was in the PR around it, in a file it never opened, or in a claim nobody ran.
1. Gate on CI first
Read every check, not a filtered list: a required check that never ran looks the same as a green one in a summary. List each row that isn't a pass and account for it (skipped by design, pending, red). A red check gets a request for changes before anything else. A failure that looks unrelated is a flake only once you have shown it: the same tree passed elsewhere, or a re-run passes, and you say which on the PR.
2. Review the PR, not just the diff
Re-read all of this on every round, not just the first:
- The body. Is the closing reference the right issue? Closing keywords ignore negation ("does not fix #12" closes #12), so read what the platform says the PR will close, not just the words. Does the evidence the body links (a run, a screenshot, a log) belong to the current head?
- The issue. Read its newest comments. A decision taken there, or in a comment, may already change what the PR should do. Find each of its acceptance scenarios in the PR, with the test or check it names; one with neither is a finding.
- The commits. One logical change each, a subject that says what changed, and no "address review" commits if the project folds feedback into the commit it fixes.
- The deletions. On a refactor or a consolidation the defect hides in the minus lines: a guard, an ordering, an isolation or a dependency that the old code had and the new code silently drops. List the properties the removed code held and find each one in the new code.
3. Verify every claim yourself
An author's "fixed in all three places" or "this can't happen" is a claim.
- Grep the unchanged tree. When a PR renames something, flips a policy or corrects a premise, search the whole repository for the old name or the old sentence. Stale text hides in files the PR never touched, including comments that now describe something untrue.
- Run it when reading can't settle it. Check the head out in a
throwaway worktree, never a checkout someone else is using, and ask what
the run actually exercised: a green run that took an early exit proved
nothing.
Never for a
communityPR: its code runs only in CI, after the operator approves the run (ADR-0069 item 5). Read its diff instead. - Open the screenshots and recordings. Look at them; don't trust the description. If you can't open them, say so on the PR rather than passing them.
- Read the code a claim depends on before you assert a race, an ordering or a library behaviour. If you can't prove it, ask; don't block on it.
- Cite only what you read. Every file:line, ID and link in the review must come from something you opened in this review.
4. Write the review where the author works
- Anchor each finding to its line as an inline comment: what is wrong, the concrete case that breaks, and the rule or decision it violates.
- The verdict body is a summary: what you checked, the findings by
severity, and one closing word. That word is either "approved at
<sha>" or "changes needed". Never both, and never "approved with some fixes please". - Label each finding's severity as
code-review-and-qualitydoes (Critical:, no prefix for required, Optional:, Nit:, FYI). The author can decline an optional one or a nit on the PR or fold it in, and either way you have the last word. - Name the head SHA you reviewed. A new push voids the approval, and the re-check starts from the interdiff since that SHA.
5. Approve only what can land
Approve without reservation only when all of these hold:
- CI is green at the head you reviewed.
- The head can merge: on current main, or queued so it will be tested there. Check this from the platform's merge state, not by reading the base SHA.
- No operator decision is pending, and no required security pass is missing.
- Docs, tests and any decision record the change needs are in the same PR.
When everything holds except a decision only the operator can make, approve it pending: say the code is done and name the open question. Don't send the merge ask until the question is answered.
6. Send the merge ask with the approval
The reviewer asks for the merge, in the same message as the final approval, with the PR link. The author never asks. Keep the chat message short, with the substance on the PR. If the PR is still unmerged hours later, send one short nudge with the link.
Re-checking after a push
- Diff the new head against the SHA you approved, not against main.
- Read only that interdiff, plus the body and the thread again (step 2).
- Re-run step 1, because the new head's CI is a new run.
- Re-approve at the new SHA, or say what is still open.
Where this differs from code-review-and-quality
- Security has its own reviewer. Note what you see on the security axis, but a PR that changes the security posture waits for the security reviewer's pass at the current head, and theirs is the verdict on it. Read their findings before you approve.
- Size alone doesn't block. Upstream says to split a change near 1000 changed lines. Here a PR closes one scoped issue, and the commits are the unit of review: ask for a split when a commit mixes changes, or when the PR covers more than its issue, not for line count. This overrides only the changed-lines threshold: upstream's file-size signal still holds, so a file nearing 1000 lines is decomposed before it grows.
- Approval has two halves. Upstream approves a change that improves the code's health. That is the first half; steps 1 and 5 above are the second. Both must hold for the approval that carries the merge ask; an approval pending an operator decision says which half is still open.
- Folding beats filing. Upstream asks for a bug filed for cleanup the change can't hold. Do that only for work outside the PR's issue; a fix inside it folds into the commit it belongs to.
In this repository
These rules from docs/CONVENTIONS.md apply; this section is what to strip
before publishing the skill elsewhere.
- Approve by a
--commentreview signed— Name · Role. The loops share one GitHub identity, so--approvefails, and no@namegoes in a GitHub body. - An approved PR gets the
queuelabel, and the merge ask is "turn on auto-merge". Any push takes it out of the queue. - A live
Operator decision pending:line blocks the merge ask, and so does aneeds-security-reviewlabel until the security reviewer has commented at the head. - A
feattouching only one ofinternal/andweb/names its other half; engine behaviour needs a tier-2 test initest/; prompts live only ininternal/loop/prompt.go; an accepted ADR changes only per/amend-adr.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

