SECURITY REVIEW / Trail of Bits
Adversarial modeler
Pins Trail of Bits' differential-review agent that models high-risk changes and says not to run on low or medium risk diffs.
“Activates only for high-risk changes, requires a concrete impact for each finding, and declares Read, Grep, Glob, and Bash.”
01 / THE REASONING
Why this made the selection.
- The catalogue has the differential-review skill and not this adversarial-modeler agent.
- The file limits itself to high-risk changes and says greenfield code without a baseline is out of scope.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/differential-review/agents/adversarial-modeler.md
- README.md
- LICENSE
- Round 2: pinned definition, output contract and permission/dependency boundaries reread on 2026-10-14
- plugins/differential-review/skills/differential-review/adversarial.md (selected input/output and dependency-contract sections; not a full implementation audit)
- plugins/differential-review/skills/differential-review/methodology.md (selected input/output and dependency-contract sections; not a full implementation audit)
Our findings
- The agent says every finding needs a concrete impact and that vague warnings are not findings.
- It says to activate for high-risk changes such as auth, cryptography, external calls, value transfer, weaker validation, or access-control changes, and not for low or medium risk, docs, tests, or formatting.
- Its tools are Read, Grep, Glob, and Bash. The plugin LICENSE path returns 404 at this commit; the root license is CC-BY-SA-4.0.
- The role is scoped to high-risk differential review and rejects greenfield work lacking a baseline.
- It cross-checks changed behavior against existing trust boundaries, invariants and git history before calling something a regression.
Not established by this review
- The resource was not executed and its tools were not called.
- The linked methodology files were not opened.
- No repository diff was reviewed with this agent.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Use the role in your project.
DOCUMENTED COMMAND
/plugin marketplace add trailofbits/skills Copying does not execute this command. It may retrieve a newer version than the reviewed source.
- The README's Claude Code install starts with the command above and then /plugin menu.
- The marketplace table names differential-review as the security-focused diff plugin. This review did not install it.
- Codex instructions in the same README use codex plugin marketplace add trailofbits/skills and a placeholder plugin name.
- Supply the matching differential-review references, bound git/source access and independently reproduce a claimed exploit in an authorized test environment.
Before you start
- Claude Code or Codex marketplace support
- A git baseline if the agent is used as written
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- adversarial-modeler ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/differential-review/agents/adversarial-modeler.md
Supports: scope, tool list, and when not to use
- Repository README ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: marketplace install line and CC-BY-SA-4.0 statement
- Repository LICENSE ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: Attribution-ShareAlike 4.0 International
- Pinned inspected source: plugins/differential-review/skills/differential-review/adversarial.md ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/differential-review/skills/differential-review/adversarial.md
Supports: Dependency setup and source-review boundary
- Pinned inspected source: plugins/differential-review/skills/differential-review/methodology.md ↗Checked
https://github.com/trailofbits/skills/blob/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/differential-review/skills/differential-review/methodology.md
Supports: Dependency setup and source-review boundary