agentleFS
rubenmarcusrubenmarcus/agent-skills/skills/critical-adversarial-review/SKILL.md

critical-adversarial-review

Skill2 starsChanged 15 days agoMITView on GitHub

Independently review a proposed change, design, or analysis for concrete failures and unsupported claims. Use when adversarial review is requested or a consequential result needs verification by someone other than its author.

The file

We split this skill into the rules it gives an agent

4 rules. About 0 are common, 4 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈4

    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
  1. Distinctive:

    Prefer a small counterexample or focused check over rerunning unrelated suites.

    line 26
  2. Distinctive:

    Use the finding contract. Include location, trigger, demonstrated failure, impact, and the smallest sound correction.

    line 32
  3. Distinctive:

    Keep style preferences separate from defects.

    line 34
  4. Distinctive:

    After fixes, review the new revision and check the original failure again.

    line 36

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Critical adversarial review

Return actionable failures supported by evidence. A useful review can find nothing; never invent findings to fill a quota.

Establish the review surface

Pin the specification, current revision or artifact hash, and relevant diff or analysis. Read the applicable project rules. For the initial independent pass, give the reviewer the required behavior and raw artifacts without the builder's persuasive summary.

Review the actual result. Verify that cited files, screenshots, traces, or measurements belong to the revision under review.

Try to falsify the result

Choose failure modes that fit:

  • A missed caller, compatibility boundary, or state transition.
  • Authorization, privacy, or untrusted input crossing a trust boundary.
  • Retries, concurrency, partial failure, stale state, or data loss.
  • A test that checks a declaration while the runtime uses something else.
  • A metric that improves while the desired behavior gets worse.
  • A conclusion depending on an unstated assumption, sample, or source.

Prefer a small counterexample or focused check over rerunning unrelated suites. Inspect code read-only by default. Execute target-controlled code only within the task's allowed environment and permissions.

For visual changes, inspect captures at the intended viewport. Technical checks cannot establish human visual acceptance.

Report and close

Use the finding contract. Include location, trigger, demonstrated failure, impact, and the smallest sound correction. Distinguish demonstrated findings from concerns needing validation.

Keep style preferences separate from defects. Report no actionable findings when that is what the evidence supports, together with material limits on coverage.

After fixes, review the new revision and check the original failure again. A resolved discussion is not evidence that the behavior changed.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.