review-pr

Generate a structured markdown review report of branch changes with severity findings.

Updated Jan 27, 2026
One-click install
npx skills add https://github.com/SamuelReeder/ROCm-workspace --skill review-pr-samuelreeder
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/SamuelReeder/ROCm-workspace/tree/main/.shared/skills/review-pr
Command: npx skills add https://github.com/SamuelReeder/ROCm-workspace --skill review-pr-samuelreeder

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automatically review a branch or PR against a clean upstream merge base, inspect changed files and related context, and write a severity-tagged markdown review report under reviews/<project>/.

Core Features & Use Cases

  • Automates PR diffs analysis and generates a structured markdown report.
  • Resolves base/upstream targets, fetches latest refs, and surfaces risk signals.
  • Works with worktrees and multiple projects to streamline code quality checks.

Quick Start

Run the review-pr workflow on your current branch to generate a structured markdown report.

Frequently Asked Questions about review-pr

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

FAQPage Schema
How do I automate PR review and generate a structured markdown report?

To automate PR review and generate a markdown report, this Skill identifies changes between your current branch and its merge-base. It outputs a severity-tagged report containing file paths, line numbers, and a final risk assessment.

What is the best way to analyze git branch diffs against a clean upstream merge-base?

Analyzing git branch diffs against a clean upstream merge-base involves resolving the correct target based on upstream refs. This process fetches the latest refs, inspects changed files, and surfaces risk signals to ensure accurate code quality checks.

Does this automated branch review tool work with multiple git worktrees?

Yes, this automated branch review tool works with git worktrees. It applies the review workflow across managed worktrees and multiple projects, streamlining code quality checks by computing the merge-base and selecting the correct target branch.

How are severity findings and risk assessments structured in the generated review report?

Severity findings and risk assessments in the generated review report are structured by severity level. The final markdown report includes specific file paths, line numbers, and a final risk assessment, stored under reviews/<project>/ with a date-stamped filename.

Can I use this PR diff analyzer without installing additional dependencies or components?

Yes, you can use this PR diff analyzer without installing additional dependencies or components. The metadata indicates it requires no external dependencies or components to compute merge-bases and generate structured markdown review reports.

When should I not use an automated markdown report generator for branch reviews?

You should not use an automated markdown report generator for branch reviews if you require inline code annotations rather than standalone files. This tool outputs structured reports under a dated filename in reviews/<project>/ instead of modifying source files directly.