differential-review

Perform security-focused differential review of code changes with git history context.

Updated May 2, 2026
One-click install
npx skills add https://github.com/ayehiaa/my-travel-assistant --skill differential-review-ayehiaa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: differential-review
Source: https://github.com/ayehiaa/my-travel-assistant/tree/main/.agents/skills/differential-review
Command: npx skills add https://github.com/ayehiaa/my-travel-assistant --skill differential-review-ayehiaa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps prevent security regressions by producing an evidence-based, phase-driven differential security review of PRs, commits, and diffs, including blast-radius and test-coverage awareness.

Core Features & Use Cases

  • Risk-first differential security review: Prioritizes auth, crypto, external calls, value transfer, and validation/invariant changes over superficial diff size.
  • Adaptive depth & evidence discipline: Scales review effort by codebase size (SMALL/MEDIUM/LARGE) and anchors findings in git history, removed-code provenance, and line-level references.
  • Comprehensive markdown reporting: Generates a structured markdown report artifact with severity, attacker context for HIGH risk, and actionable recommendations.
  • Best-fit use cases: Reviewing security-sensitive changes before merge, validating whether removed checks reintroduce known classes of issues, and documenting findings for audits/stakeholders.

Quick Start

Run differential-review on the pending changes and save the generated markdown report for merge/triage.

Frequently Asked Questions about differential-review

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

FAQPage Schema
How do I catch security regressions in a pull request code diff?

To catch security regressions in a pull request code diff, perform a differential security review that prioritizes risky behaviors like auth and crypto changes. This approach validates code invariants against git history and estimates blast radius to prevent merge vulnerabilities.

What is differential security analysis and when do I need it?

Differential security analysis is a targeted review of code changes rather than the entire codebase. You need it when reviewing security-sensitive changes before merge, validating if removed checks reintroduce vulnerabilities, or documenting findings with attacker scenarios for stakeholder audits.

How does blast radius estimation work during a git history security review?

Blast radius estimation during a git history security review assesses the potential impact scope of risky changes by analyzing removed-code provenance and line-level references. It scales review effort adaptively across codebases to pinpoint affected system areas.

Can I use adaptive code analysis for large commit ranges?

Yes, you can use adaptive code analysis for large commit ranges because review depth scales automatically according to codebase size classifications. This ensures evidence-backed findings and comprehensive markdown reporting without overwhelming the analysis.

Best way to document high risk vulnerabilities with attacker modeling?

The best way to document high risk vulnerabilities with attacker modeling is to generate a structured markdown report artifact that includes concrete attacker scenarios, severity ratings, and actionable recommendations anchored by line-level references from the diff.

Why does test coverage matter when validating removed code in a diff?

Test coverage matters when validating removed code in a diff because it verifies whether removing checks or invariants reintroduces known classes of security issues. Differential analysis includes test coverage checks to ensure removed validations do not leave remaining code exposed.