reviewing-changes
Skill33 starsChanged 35 days agoApache-2.0View on GitHub
Review an actual candidate against the user's acceptance and scope, then carry findings through fixes, affected checks and rereview. Use before claiming a substantive change complete or accepting a worker's implementation.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- okgrit/done-is-a-claimword for word, first seen Nov 8, 2026
- bitwarden/iostheir own version, first seen Oct 8, 2026
- bitwarden/androidtheir own version, first seen Oct 8, 2026
- calebnewtonusc/Chewbaccatheir own version, first seen Aug 11, 2026
- vanenshi/skillstheir own version, first seen Aug 5, 2026
- mr-ashishpanda/claude-workspace-endpointtheir own version, first seen Jun 30, 2026
Other versions6 projects use a version of this.
Word for word · 1
- okgrit/done-is-a-claim★ 33100% same
Edited · 0
None found.
Wrote their own version · 5
- bitwarden/android★ 9.6ksame name
- bitwarden/ios★ 731same name
- calebnewtonusc/Chewbacca★ 8same name
- vanenshi/skills★ 2same name
- mr-ashishpanda/claude-workspace-endpoint★ 1same 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 repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- acceptance-designSkill
- checking-deliverySkill
- collecting-worker-resultsSkill
- debugging-with-evidenceSkill
- evidence-freshnessSkill
- executing-plansSkill
- implementing-with-testsSkill
- planning-changesSkill
- public-claimsSkill
- reading-measurementsSkill
- responding-to-reviewSkill
- resuming-workSkill
- using-done-is-a-claimSkill
- whose-redSkill
The file
We split this skill into the rules it gives an agent
9 rules. 0 are common, 6 are distinctive, and 3 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 14
Read the user outcome, acceptance commands, preserved behavior and scoped file ownership.
- Distinctive: line 18
Read existing check output, command, exit status and input identity.
- Distinctive: line 32
Check that generated artifacts, consumers or rendered output work where those are part of acceptance.
- Distinctive: line 34
Keep aesthetic preferences separate from contract defects and avoid scope growth.
- Very specific: line 46
If a failure needs attribution, use host-discovered whose-red when available.
- Very specific: line 53
When receiving external comments, use host-discovered responding-to-review if available.
- Distinctive: line 60
When fixes are authorized and within your ownership, correct supported defects.
- Distinctive: line 64
After each meaningful fix, run affected acceptance and regression checks.
- Very specific: line 74
Use evidence-freshness only at a host-discovered location if available.
“Common” is measured: kept by at least 6 in 10 of the 4 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
Reviewing changes
Review the delivered candidate, not the author's confidence or task status. Support findings with the user's contract, the actual diff and observable behavior. A review is useful only to the extent its inspected scope is clear.
Establish the review inputs
- Read the user outcome, acceptance commands, preserved behavior and scoped file ownership. Confirm the assigned checkout and applicable instructions.
- Identify base and candidate revision, plus uncommitted and untracked inputs. Inspect the diff and affected artifacts directly. Verify referenced paths.
- Read existing check output, command, exit status and input identity. Treat author and worker reports as leads; do not turn a result label into evidence.
- State the review mode. Use an independent reviewer when permitted and available with a bounded brief and evidence. Otherwise perform self-review explicitly, naming the loss of independence without pretending another agent ran.
Look for consequential defects
Evaluate the candidate against the original outcome, compatibility, edge cases and relevant callers. Confirm checks can distinguish the intended behavior from a plausible failure. A constant assertion, file existence or successful response alone may not test the boundary the user cares about.
Inspect all affected call sites for a defect class, not only the example fixed. Check that generated artifacts, consumers or rendered output work where those are part of acceptance. Name anything inaccessible instead of assuming it works. Keep aesthetic preferences separate from contract defects and avoid scope growth.
For every supported finding, record severity or practical impact, file locator, reproduction or evidence, violated outcome and a concrete correction direction. State uncertainty when evidence is incomplete. Do not invent findings to fill a quota; a scoped review with no findings is still bounded by what was inspected.
Rerun agreed acceptance yourself on the candidate and the whole relevant suite. Capture the commands' own exit codes and actual summaries, including collection counts. Read every required CI result on the identified revision where applicable. Failed, skipped, unavailable and empty checks remain gaps, even if one check passes.
If a failure needs attribution, use host-discovered whose-red when available;
otherwise compare matched runs and report the limits. A baseline failure does not
exonerate extra candidate failures or changed behavior. Use
debugging-with-evidence if discovered when a separating experiment is needed.
Resolve findings without losing the evidence
When receiving external comments, use host-discovered responding-to-review
if available. Otherwise compare each comment with the current candidate and
contract inline. A stale location, confident reviewer or repeated bot comment
does not establish a defect. Explain unsupported suggestions with evidence;
continue independent supported fixes while consequential questions are unresolved.
For a review-only assignment, return findings to the owner without editing. When fixes are authorized and within your ownership, correct supported defects. Delegate only within existing permission and available capabilities; coordinate overlapping writers rather than assuming ownership or requiring arbitrary worktrees.
After each meaningful fix, run affected acceptance and regression checks. Rereview the changed parts and every unresolved finding; mark a finding resolved only with evidence for its correction. Continue this loop while authorized fixes remain. If a blocker prevents a fix or check, state it and its effect on acceptance. An initial review does not certify edits made afterward.
Return a current verdict
Bind the final verdict to the resulting revision and dirty inputs. Rerun final
acceptance yourself and confirm the relevant inputs did not change during the run.
Use evidence-freshness only at a host-discovered location if available; otherwise
compare the inputs inline. Delivery claims need destination observations within
existing authorization, using discovered checking-delivery or inline inspection.
Return review mode and scope, findings and resolutions, files, observed checks, evidence paths and remaining limits. Say what those observations establish; an independent review, current green CI or usable delivery each needs its own evidence.
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.

