Compatible with Cursor, Claude Code, Cline, Roo Code, Antigravity, GitHub Copilot

Pull Request Severity-Graded Review

Structured PR review workflow categorizing findings into Blocker, Major, Minor, and Nitpick with actionable diffs.

GitGitHubCode ReviewBest Practices

v1.0.0 · Updated 2026-08

Skill Objective

Perform a thorough asynchronous pull request review, categorizing feedback into actionable severity levels with exact file locations and code fixes.

Execution Workflow Procedure

Ordered steps the coding agent executes when performing this skill.

Analyze PR Intent & Scope

Read the PR title, description, and acceptance criteria to understand the business intent before reviewing line-by-line diffs.

Categorize Findings by Severity

Evaluate changes against Blockers (security/crashes/breaking changes), Major (architecture/error handling), Minor (naming/clarity), and Nitpick (formatting).

Provide Concrete Code Diffs

For every identified issue, explain why it matters and supply the exact replacement code snippet.

Agent Safety Guardrails & Anti-Hallucination Rules

DO NOT block a pull request over stylistic nitpicks or minor formatting preferences.
DO NOT leave vague comments; always provide concrete failure scenarios and solutions.

Expected Output Format

Structured GitHub-ready markdown review.

🔴 Blocker: Issues that cause crashes, security flaws, or breaking changes.

🟠 Major: Architecture flaws, missing error handling, or poor queries.

🟡 Minor: Readability, documentation, or small refactorings.

⚪ Nitpick: Non-blocking stylistic suggestions.

Domain Verification Checks

Severity Triage: Separates merge-blocking bugs from constructive improvements.

Concrete Fix Diffs: Provides copy-pasteable replacement code for every issue.

Scope Adherence: Verifies the PR does not introduce unrelated scope changes.

Example Agent Invocations

"Review the git diff on this branch and group comments by severity level."

"Perform a final sanity review on this PR before we request team approval."

Install / Configure This Skill

# Place in .cursorrules or create .cursor/rules/pull-request-severity-review.mdc
# Trigger: Whenever you perform pull request severity-graded review

---
name: pull-request-severity-review
description: Perform an asynchronous pull request review categorized into Blocker, Major, Minor, and Nitpick with actionable diffs.
version: 1.0.0
compatibility: [Cursor, Claude Code, Cline, Roo Code, Antigravity]
---

# Pull Request Severity-Graded Review

## Objective
Deliver constructive, high-signal pull request reviews that distinguish critical merge blockers from minor stylistic preferences.

## Workflow
1. **Understand PR Scope**: Read the PR description and acceptance criteria.
2. **Severity Grading**:
   - 🔴 **Blocker**: Security vulnerabilities, crashes, data corruption, or breaking changes.
   - 🟠 **Major**: Missing error handling, N+1 queries, race conditions, or missing tests.
   - 🟡 **Minor**: Code clarity, naming improvements, or small optimizations.
   - ⚪ **Nitpick**: Non-blocking formatting or optional preferences.
3. **Actionable Feedback**: Reference exact file paths and lines with replacement diffs.

Complementary Agent Prompt

Need a quick one-time prompt for chat?

Try the Pull Request Severity-Graded Code Review — a lightweight version designed for 1-click copying directly into Claude, ChatGPT, or Cursor chat.

View Prompt