refute-review
Skill0 starsChanged 43 days agoMITView on GitHub
Verify that an agent's work is really done by trying to refute it (re-run the checks, read the assertions, run a red-green proof, demand evidence). Use when an agent or person claims work is done, fixed, passing or ready to merge, when asked to review, double-check, audit or independently verify a change, or when asked how to check an agent's claim.
In this repository6 other files it gives its agents.
- templates/AGENTS.mdAGENTS.md
- failure-to-ruleSkill
- handoffSkill
- release-gateSkill
- risk-tiersSkill
- sprint-specSkill
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 5 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
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 21
If it is pinned to one branch, say so: a claim that needs another branch is reported unsupported, not guessed.
- Distinctive: line 26
Read each assertion. A matching test name is not proof.
- Distinctive: line 31
Look beside the fix for the same defect shape.
- Distinctive: line 32
Check scope: files touched, new dependencies, weakened assertions, regenerated baselines.
- Distinctive: line 39
After a batch merges, review the merged branch as a whole.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Refute review
Goal: find what would make "done" false. Approval is the absence of a refutation, not the presence of a summary.
Agents: refuting-reviewer for one change, auditor (finder, then skeptic) for a broad sweep. Command: /agent-operating-kit:refute.
Independence
- A fresh context that is not the implementer and is told to refute, not bless.
- It reads the diff, the assertions and the direct artifacts, and re-runs the checks itself. The implementer's report is a list of claims to test, never evidence.
- A different model, extra votes or a title does not make a review independent.
Brief
- The outcome under review. Checkout path, branch and exact revision. The files it may touch.
- The claims, verbatim, marked untrusted. The acceptance checks and the risk tier.
- "Try to refute this. Report what you could not verify."
- If it is pinned to one branch, say so: a claim that needs another branch is reported unsupported, not guessed.
What the reviewer does
- Pin the candidate (revision, dirty flag). Review the diff, not the summary.
- Re-run every acceptance check. Record command, exit code and counts. "Skipped" and "0 tests found" are failures until shown otherwise.
- Read each assertion. A matching test name is not proof. An at-most check cannot show a bound got tighter.
- Red-green. Revert the fix in a throwaway copy: the new test must fail. Restore it: the test must pass.
- Hollow gate. Break what the gate exists to catch: it must go red. Cases generated from a directory or manifest can vanish instead of failing.
- Grader fault injection. An eval or model judge earns trust only if it fails when the behavior it grades is deliberately broken.
- Trace from the real entry point to the changed code and confirm the shipped artifact contains it.
- Look beside the fix for the same defect shape.
- Check scope: files touched, new dependencies, weakened assertions, regenerated baselines.
Verdict
PASS, PASS WITH FOLLOW-UPS or FAIL. A status per claim. Findings with reproduction steps. The commands run. What was not verified.
After
- A FAIL goes back to the implementer, not to the reviewer. Re-review the new revision from scratch.
- After a batch merges, review the merged branch as a whole. Per-change reviewers attack only their own diff, so regressions live between changes.
- For a high-severity finding use two skeptics with different lenses (for example reachability from the entry point, and correctness against existing mitigations). Drop it only if both refute it. Settle disagreement by reading code or running the check, not by vote.
- For a broad audit, give each
auditorfinder a slice with no gaps and no overlaps, then run skeptics on the strongest model available. - Depth follows the risk tier. Agent count is not a success metric.
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.

