differential-review

Analyze security-focused git diffs and generate markdown audit reports.

6.5k|561|Updated Jan 14, 2026
One-click install
npx skills add https://github.com/trailofbits/skills --skill differential-review-trailofbits
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: differential-review
Source: https://github.com/trailofbits/skills/tree/main/plugins/differential-review/skills/differential-review
Command: npx skills add https://github.com/trailofbits/skills --skill differential-review-trailofbits

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Performs security-focused differential review of code changes (PRs, commits diffs). Adapts analysis depth to codebase size, uses git history for context, calculates blast radius, checks test coverage, and generates comprehensive markdown reports. Automatically detects and prevents security regressions.

Core Features & Use Cases

  • Baseline context integration for security invariants and trust boundaries during diff analysis
  • Phase-driven workflow (Intake, Triage, Code Analysis, Test Coverage, Blast Radius, Deep Context, Adversarial, Report)
  • Blast radius calculation and risk-based prioritization to guide audit focus
  • Test coverage evaluation and regression detection for changed code
  • Generates structured markdown audit reports suitable for stakeholders and compliance
  • Adversarial analysis guidance for HIGH risk changes and formal vulnerability storytelling

Quick Start

Run the differential-review workflow on a PR range to generate a comprehensive markdown report.

Frequently Asked Questions about differential-review

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate security code review for git pull requests and commits?

Automated security code review analyzes PRs and commit diffs to identify regressions, calculate blast radius, and generate structured markdown audit reports. It uses baseline context and phase-driven triage to document security-focused changes across your git history.

What is differential review and when should I use it for security audits?

Differential review is a security-focused analysis of code changes across PRs and commits to detect regressions. Use it when you need traceable evidence, risk stratification, and audit-ready markdown reports for codebases with active git histories and evolving trust boundaries.

Can I generate compliance-ready audit reports from git diff content?

Yes, you can generate compliance-ready audit reports from git diff content. The workflow produces a structured markdown report aligned with differential review methodology, incorporating risk stratification, blast radius assessment, and adversarial analysis for high-risk changes.

How does blast radius assessment work during a security code diff review?

Blast radius assessment calculates the potential impact of changed code to guide audit focus and risk-based prioritization. It evaluates test coverage and regression risks, coordinating baseline context with security invariants to determine the scope of affected trust boundaries.

Does automated diff review work without external dependencies or components?

Automated diff review operates with no external dependencies, analyzing git histories and diff content directly. It adapts analysis depth to codebase size and applies phase-driven workflows independently to produce security audit reports.

How do I prevent security regressions when merging new code changes?

To prevent security regressions, run a phase-driven diff review that applies baseline context for security invariants, evaluates test coverage for changed code, and performs adversarial analysis on high-risk changes to automatically detect and document potential vulnerabilities.