review-pr

Reviews GitHub pull requests with the gh CLI and produces structured readiness feedback.

Updated Feb 16, 2026
One-click install
npx skills add https://github.com/travis-burmaster/agentbox --skill review-pr-travis-burmaster
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/travis-burmaster/agentbox/tree/main/agentfork/.agents/archive/review-pr-v1
Command: npx skills add https://github.com/travis-burmaster/agentbox --skill review-pr-travis-burmaster

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing pull requests thoroughly requires checking diffs, security, tests, docs, and changelogs, which is easy to do inconsistently or skip under time pressure. This Skill enforces a repeatable, read-only review workflow that produces a structured readiness recommendation without risking accidental merges or pushes. ## Core Features & Use Cases - Isolated worktree reviews: Checks out the PR in a dedicated git worktree so the main working tree stays untouched. - Structured A-through-J report: Produces a TL;DR recommendation, security findings, concerns ranked as BLOCKER/IMPORTANT/NIT, test and docs status, and a suggested PR comment. - Duplicate detection: Searches main for existing implementations of the PR's feature before evaluating the diff. - Use Case: A maintainer receives a community PR and asks the agent to review it; the agent inspects the diff, flags a missing changelog entry and an unvalidated input as IMPORTANT, saves the review to .local/review.md, and recommends NEEDS WORK. ## Quick Start Ask the agent to review pull request number 123 using the review-pr skill and provide a readiness recommendation.

Frequently Asked Questions about review-pr

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

FAQPage Schema
How do I review a GitHub pull request with the gh CLI?

Use gh pr view to fetch PR metadata and gh pr diff to read the changes, then inspect the code in an isolated git worktree. This Skill automates that flow and outputs a structured review with a readiness recommendation.

How to review a PR without merging or pushing changes?

Perform the review in a dedicated git worktree based on origin/main and treat all operations as read-only. This Skill explicitly forbids git push and merging, and never touches main during the review.

Can this Skill modify or merge the pull request it reviews?

No. The Skill is strictly review-only: it never runs git push, never merges, and never commits changes. It only saves findings to .local/review.md and .local/pr-meta.env inside the worktree for later handoff.

What does the structured PR review output include?

The review contains sections A through J: a TL;DR recommendation, summary of changes, strengths, security findings, ranked concerns (BLOCKER, IMPORTANT, NIT), test and docs status, changelog needs, follow-ups, and an optional suggested PR comment.

Why does the review fail with 'fatal: not a git repository'?

This error means the commands are running outside the repository. Move to the repository root, verify with git rev-parse --show-toplevel, then rerun the worktree setup and review steps from there.