pr-review-kitlisted
Install: claude install-skill jamestexas/agents
A complete, self-contained playbook for reviewing a pull request. Hand this file to a fresh reader — human or Claude session — along with the target PR, and they have everything needed to do a rigorous review without prior context.
---
## How to use this document
**You are a new reader.** This kit does not assume:
- You know about other skills, agents, or memory entries in any parent repo.
- You know the project's design conventions.
- You know the PR author's review style.
- You have any prior session history.
It assumes only that you have:
- `gh` CLI authenticated to the relevant org.
- `git` with worktree support.
- File read/write access in the reader's home dir.
- (Optional) Specialty subagents available via the harness — generic instructions below cover dispatch when they exist.
**Two reading modes:**
- **Mode A — Doing a review yourself.** Read top-to-bottom; phases are sequential.
- **Mode B — Coordinating multiple reviews.** Skip to Phase 7 (output format) — the per-PR notes file shape is the durable artifact you'll keep.
---
## Phase 1 — Read the PR state cold
Before forming any opinion, build a complete picture of the PR's metadata, review history, and commit history. Run these in parallel:
```bash
OWNER=<github org>
REPO=<github repo>
N=<PR number>
# Core PR metadata (title, author, size, state, mergeable)
gh pr view $N --repo $OWNER/$REPO \
--json number,title,author,state,additions,deletions,changedFiles,baseRefName,headRefName,createdAt,updatedAt