review-pr

Review pull requests with a guided, mode-aware process using git and GitHub CLI.

5|Updated Apr 9, 2018
One-click install
npx skills add https://github.com/angusjfw/hbz --skill review-pr-angusjfw
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/angusjfw/hbz/tree/main/claude/skills/review-pr
Command: npx skills add https://github.com/angusjfw/hbz --skill review-pr-angusjfw

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

The review-pr Skill solves the challenge of effectively reviewing Pull Requests (PRs) in a software project. It offers a guided, step-by-step process that helps in thoroughly understanding, evaluating, and providing feedback on PRs.

Core Features & Use Cases

  • Guided Review Process: A structured walkthrough to assess PRs, including issue understanding, approach evaluation, change review, and synthesis of findings.
  • Self-review vs. Colleague Review: Differentiate between self-review for your own PRs and colleague review for others, adjusting the review depth and approach accordingly.
  • Worktree Setup: Ensures that the review process occurs in a local worktree, maintaining an accurate context and diffing against the remote branches.

Quick Start

Use the review-pr Skill to start reviewing your PR by running: /review-pr.

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 step by step?

To review a GitHub PR step by step, this Skill provides a structured walkthrough covering issue understanding, approach evaluation, change review, and synthesis of findings, guiding you systematically through the entire process.

Can I use this for self-review of my own PRs versus colleague review?

Yes, you can use this for both self-review and colleague review. The Skill differentiates between reviewing your own PRs and reviewing others' PRs, adjusting the review depth and approach accordingly for each collaborative context.

Do I need git and GitHub CLI to review PRs with a structured approach?

Yes, you need git and GitHub CLI to review PRs with this structured approach. The Skill requires git operations for local worktree management and uses various GitHub API commands to gather and present the necessary PR information.

What is a local worktree setup and why is it needed for PR review?

A local worktree setup for PR review ensures the review process occurs in an isolated environment, maintaining accurate context and diffing against remote branches. This setup helps evaluate code changes precisely before merging.

Does this PR review process support code analysis using Python agents?

Yes, the PR review process supports code analysis using Python agents. The Skill is designed for comprehensive PR review and potentially leverages other Python agents to enhance code analysis during the evaluation process.

What's the best way to start reviewing a pull request?

The best way to start reviewing a pull request is to run the `/review-pr` command. This initiates a guided, step-by-step process that helps you thoroughly understand, evaluate, and provide feedback on PRs.