# review-pr

Reviews GitHub pull requests in CI: hunts for defects, reconciles earlier feedback, and posts inline findings.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2300 installs
- Author: dbpolito
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dbpolito/skills/tree/HEAD/skills/review-pr/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/review-pr

## What it does

This skill runs a pull request review on its own. It pins the base and head commits, then walks the merge-base-to-head diff: entry points, callers, dependencies, migrations, caching, concurrency. Every candidate defect gets challenged before it is published, so only findings with a concrete trigger and a real consequence make it into the report.

It leans on `git`, `gh` and `jq`. A separate pass handles prior reviews and comments: duplicates collapse by root cause, fixed items are marked closed, disputed ones are rechecked against the pinned code. Its own earlier posts are recognized by the `REVIEW_LOGIN` value and the `<!-- review-pr -->` marker.

The skill leaves the index, branches and pinned revisions alone. It reads test code but will not run tests or CI logs unless you ask for that explicitly in the review request, and it never merges, dismisses reviews or edits PR metadata. When the checkout `HEAD` does not match the PR head, it stops and prints both SHAs; for GitHub Actions' synthetic merge checkout it suggests `ref: ${{ github.event.pull_request.head.sha }}` on `actions/checkout`.

## Requirements
- Works with: GitHub

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add dbpolito/skills --skill review-pr -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/review-pr/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/review-pr/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add dbpolito/skills --skill review-pr -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/review-pr/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add dbpolito/skills --skill review-pr -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/review-pr/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dbpolito/skills review-pr
```

2. **Manually: put the files in place**
- File: `.github/skills/review-pr/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add dbpolito/skills --skill review-pr -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/dbpolito/skills --path skills/review-pr
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/review-pr/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add dbpolito/skills --skill review-pr -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/dbpolito/skills/tree/HEAD/skills/review-pr/SKILL.md

## When to use it
- catch defects in a pull request before merge
- cover the whole merge-base-to-head diff, deletions and renames included
- reconcile earlier reviewer comments with the current code
- drop duplicate findings by root cause
- get inline comments posted on the PR

## Example prompts
- Review the pull request in this repository and post inline findings
- Reconcile your findings with earlier reviews and drop duplicates
- Check that checkout HEAD matches the PR head, then walk the diff

## Similar
- [improve-codebase-architecture](https://affpapa.org/en/nevibecode/skills/improve-codebase-architecture.md) — skill · 1163035 installs
- [tdd](https://affpapa.org/en/nevibecode/skills/tdd.md) — skill · 1141062 installs
- [triage](https://affpapa.org/en/nevibecode/skills/triage.md) — skill · 990453 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/code-review.md) — skill · 789521 installs
- [implement](https://affpapa.org/en/nevibecode/skills/implement.md) — skill · 774700 installs

## Other versions with the same name
- [review-pr · tirth8205](https://affpapa.org/en/nevibecode/skills/tirth8205-review-pr.md) — 1200 installs
- [review-pr · neolabhq](https://affpapa.org/en/nevibecode/skills/neolabhq-review-pr.md) — 1200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
