skills.rest
williamthorsen
williamthorsenCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

review-pr

Reviews pull requests on GitHub or Bitbucket by delegating platform-specific metadata fetching and running a shared branch-review process.

1|1|Updated Feb 25, 2026
Search Tags:#diff analysis#code review#pull request#github#bitbucket#specification compliance#delegate
One-click install
npx skills add https://github.com/williamthorsen/codeassembly --skill review-pr-williamthorsen
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-pr
Source: https://github.com/williamthorsen/codeassembly/tree/main/packages/agents/content/skills/review-pr
Command: npx skills add https://github.com/williamthorsen/codeassembly --skill review-pr-williamthorsen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing a pull request requires gathering PR metadata, verifying the local checkout matches the PR head, resolving linked tickets, and analyzing the diff against specifications. This Skill automates that orchestration so a PR review runs consistently regardless of platform. ## Core Features & Use Cases - Platform detection and delegation: Detects GitHub or Bitbucket from preferences, git remotes, or the PR URL, then dispatches to the matching delegate (review-gh-pr or review-bb-pr) to fetch PR metadata and verify HEAD matches the PR's head commit. - Shared review process: Invokes review-branch's diff analysis, finding generation, and "Specification compliance" rendering with resolved inputs, evaluating the implementation against both the ticket and the PR description. - Use Case: After running gh pr checkout 1024, invoke the review with the PR number to produce a saved review artifact with findings, scoring, and next steps such as posting findings on the PR. ## Quick Start Check out the pull request branch locally, then ask the agent to review PR 1024 with an optional diff base or ticket override.

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 pull request with this workflow?▼

Check out the PR branch first (for example with gh pr checkout), then invoke the review with the PR number or full URL. The skill detects the platform, fetches PR metadata via a delegate, and runs the shared branch-review process.

Does it support both GitHub and Bitbucket pull requests?▼

Yes. Platform detection checks preferences, the git remote URL, and the PR URL host, then dispatches to review-gh-pr for GitHub or review-bb-pr for Bitbucket. A full URL overrides the detection cascade.

Why does the PR review fail with a HEAD-mismatch error?▼

The delegate compares git rev-parse HEAD to the PR's head commit and stops if they differ. Check out the PR branch using the platform-specific command shown in the error message, then rerun the review.

How do I review a stacked PR against a non-default base branch?▼

Pass --diff-base=<ref> to override the default base. The review then analyzes merge-base(HEAD, <ref>)..HEAD instead of the PR's baseRefName, which suits stacked pull requests.

What specification sources does the PR review evaluate against?▼

By default it evaluates against two sources: the resolved ticket and the PR description. Divergence between them is reported in the Specification consistency section of the review output.

Related Skills

Explore More Software Engineering Skills→
paywherebpaywhereb

pull-latest

Checkout the default branch and pull latest commits from origin.

Official
Intermediate
DGouronDGouron
41

review-followup-example

Verify review comments are addressed in new commits and generate follow-up reports.

Community
Intermediate
Dev10x-GuruDev10x-Guru
7

Dev10x:gh-pr-create

Automate GitHub pull request creation with ticket extraction and Job Story summaries.

Official
Advanced
JetBrainsJetBrains

update-pr

Stage, commit, and push updates to an existing feature branch.

Official
Intermediate