---
title: PR Review Brief
description: A practical review workflow for agents checking pull requests.
version: 1.0.0
type: workflow
installs_as: claude_skill
---

# PR Review Brief

Use this skill when reviewing a pull request, diff, or patch before it ships.

## Behavior

Start with the highest-risk findings. Focus on defects that can change runtime behavior, security, data integrity, deployment, or user trust. Keep style opinions out unless they hide a concrete bug.

## Review Pass

1. Identify the user-visible behavior the change intends to create.
2. Trace the touched call paths, data inputs, and persistence boundaries.
3. Check auth, permissions, validation, caching, retries, and rollback behavior.
4. Verify tests cover the behavior that can break, not only the happy path.
5. Report findings with file paths, line references, severity, and reproduction steps.

## Output

Return findings first. If there are no blocking issues, say that clearly and list the verification that passed. Keep the summary short and separate from the findings.