30-SECOND BRIEF
What it does—and when it fits
Differential Review is Trail of Bits' risk-first security review for pull requests, commits, and diffs. It adapts depth to repository size, uses history and test coverage, estimates blast radius, and escalates high-risk changes into adversarial analysis.
INSTALL BY AGENT
Choose your Agent
Paths come from official Agent docs or the universal installer behind skills.sh. Compatibility still follows this Skill's record.
.claude/skills/differential-review/~/.claude/skills/differential-review/Use project scope for team sharing and personal scope across repositories. The installer defaults to project scope; add -g for personal scope.
npx skills add trailofbits/skills --skill differential-review --agent claude-codeClaude Code discovers custom Skill folders automatically at project or personal scope.
View path evidence ↗TYPICAL WORKFLOW
A practical workflow
Triage changed files
Classify authentication, cryptography, external calls, and state changes by risk.
Trace blast radius
Use callers, dependencies, history, and removed safeguards to identify downstream impact.
Write evidence-backed findings
Connect each issue to lines, commits, tests, and concrete attack scenarios.
THE TRADEOFFS
Advantages and tradeoffs
Notable strengths
- Prioritizes risky behavior over diff size and cosmetic change volume.
- Makes coverage limits and confidence explicit in a durable report.
Limitations
- Not intended for greenfield code or broad initial vulnerability discovery.
- Large, high-risk changes can require hours of focused human review despite the workflow.
BEST FIT
Who it is for
Security reviewers assessing consequential code changes
Maintainers who need a traceable PR risk record
BEFORE YOU USE IT
Risks to review before use
False assurance from incomplete context
A diff review can miss unchanged vulnerable dependencies, runtime configuration, or callers outside the available repository. State scope and do not convert review coverage into a security guarantee.
SECURITY
What the permission profile means
- Treat repository history and issue links as potentially sensitive evidence.
- Require reproducible attack paths before escalating a speculative finding.
Not a security certification. External ratings are attributed references. SkillSignal has not independently executed or security-reviewed this Skill.
INSIDE THE PACKAGE
Indexed files
TAGS
Original SkillSignal editorial profile grounded in Trail of Bits commit 9b281335, checked 2026-08-20; not independently executed or security-certified.