respond-to-review
Skill0 starsChanged 3 months agoMITView on GitHub
Process code-review findings — from an automated reviewer or a human — point by point, with judgment. Use when a review lands on a PR and the findings need to be resolved.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- chrislacey89/skillstheir own version, first seen Nov 1, 2026
- dativo-io/talontheir own version, first seen Oct 25, 2026
- rome-os/rometheir own version, first seen Oct 21, 2026
- eloqdata/eloqkvtheir own version, first seen Oct 8, 2026
- SteveVitali/agent-discoursetheir own version, first seen Aug 20, 2026
- igmarin/elixir-phoenix-skillstheir own version, first seen Jul 21, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- eloqdata/eloqkv★ 1.5ksame name
- rome-os/rome★ 894same name
- dativo-io/talon★ 18same name
- chrislacey89/skills★ 4same name
- igmarin/elixir-phoenix-skills★ 4same name
- SteveVitali/agent-discourse★ 0same name
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 repository12 other files it gives its agents.
- templates/CLAUDE.mdCLAUDE.md
- build-supervisedSkill
- decomposeSkill
- diagnoseSkill
- handoffSkill
- interrogateSkill
- prdSkill
- setup-playbookSkill
- specSkill
- spikeSkill
- tddSkill
- verify-liveSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 3 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 6 edited versions we read keep these.
3
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 47
If a round lands after your last commit, the PR is not done — findings outstanding at merge time must be explicit deferrals, never silence.
- Distinctive: line 52
When the operator can't audit patches, findings are arbitrated in behavior terms instead: convert each finding into a question about …
- Distinctive: line 62
If you have not declined a finding in recent memory, you are in relay mode — the reviewer is doing your judgment for you.
“Common” is measured: kept by at least 6 in 10 of the 6 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
Respond to Review
An adversarial reviewer is only as valuable as the argument you have with it. Bulk-accepting every finding turns the reviewer into your last line of defense (it will eventually miss); ignoring findings for days rots the PR. The protocol: every finding answered, in hours, with judgment.
Protocol
- Number every finding from all review rounds. Nothing unaddressed — an unanswered finding reads as an unread one.
- For each, choose one of three verbs:
- Accept — fix it AND add the regression test that would have caught it. A fix without a test is the same bug with better luck.
- Decline — with a reason grounded in the code ("the guard at L590 deliberately lets stale rows through; excluding them here would break the documented recovery path"), not in preference. Declining well is the signal you're reviewing the reviewer.
- Defer — real, but not this PR. File the ticket in the same breath and link it.
- Audit suggested patches before applying. Reviewer fixes carry their own bugs — check the proposed ordering, the edge the reviewer didn't consider, the interaction with code outside the diff. Finding a bug in the reviewer's fix is the protocol working, not friction.
Reply once per round, point by point, with verification evidence: test counts before/after, typecheck status, and the live-drive proof if behavior changed. Format:
Addressed in <commit> — point by point: 1. <finding> — fixed; regression test `<name>`. One deviation from the suggested patch: <why the suggestion had a hole, what was done instead>. 2. <finding> — declined: <code-grounded reason>. 3. <finding> — deferred to <ticket>: <why it's separable>. Verification: typecheck clean; tests X → Y, 0 failures; re-drove <flow>.
Tempo
- Answer within hours. A finding answered same-day costs one context reload; answered next week it costs a full re-review.
- If a round lands after your last commit, the PR is not done — findings outstanding at merge time must be explicit deferrals, never silence.
Non-coding operators
When the operator can't audit patches, findings are arbitrated in behavior
terms instead: convert each finding into a question about observable
behavior, require the fix demonstrated live (both orderings, for races),
and decline only on product grounds anchored in the PRD or PRINCIPLES.md
— never on "seems unlikely". The accept-with-test rule survives translation:
accepted means fixed, demonstrated, and pinned by a regression test. Full
protocol: docs/pm-onramp.md.
Self-check
If you have not declined a finding in recent memory, you are in relay
mode — the reviewer is doing your judgment for you. If reviewers keep
finding the same category (timezone edges, missing failure paths), that
category belongs in your /interrogate checklist, upstream of generation.
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.

