# branch-review-before-pr

branch-review-before-pr reviews a branch diff against the default base and reports merge-stopping defects before the PR exists. Edits nothing until you approve a fix.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 167 installs · ★ 5 repo stars
- Author: ulpi-io
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ulpi-io/skills/tree/HEAD/branch-review-before-pr/SKILL.md
- Updated: 2026-08-31
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/branch-review-before-pr

## What it does

The skill reads the whole branch diff against its base (usually `origin/main` or `origin/master`) and hunts for what tests skip: risky queries, race conditions, auth and trust-edge mistakes, side effects buried in conditions. It works in two rounds, and round one covers only issues that should stop the merge.

Each candidate gets checked against the code around it before it reaches the report, so problems already handled nearby fall away. Stopping issues come first, informational ones after, and a clean branch is stated as clean. Categories and suppressions live in `checklist.md` inside the skill.

No edit happens until you choose “Fix it now” for one particular issue. Every stopping issue gets its own question, so nothing is decided in bulk and nothing is fixed behind your back. The skill never commits, pushes or opens the PR. Formatting preferences stay out of the report — if you want style nits, this is not the tool.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ulpi-io/skills branch-review-before-pr
```

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

### Gemini CLI

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

2. **Platform CLI**
```bash
gemini skills install https://github.com/ulpi-io/skills --path branch-review-before-pr
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add ulpi-io/skills --skill branch-review-before-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/ulpi-io/skills/tree/HEAD/branch-review-before-pr/SKILL.md

## When to use it
- catch a risky query in the diff before it merges
- sort merge-stopping findings from informational ones
- check a branch for race conditions and auth holes
- decide on each blocker one at a time instead of in a batch
- confirm a branch is clean before opening the PR

## Example prompts
- Run `branch-review-before-pr` on this branch against `origin/main`, focus on the data access layer.
- Review the branch with `branch-review-before-pr`; I only care about blocking findings.
- Use `branch-review-before-pr` with no focus hint and read the full diff against `origin/master`.

## Similar
- [review](https://affpapa.org/en/nevibecode/skills/garrytan-review.md) — skill · 514 installs
- [code-review](https://affpapa.org/en/nevibecode/skills/waybarrios-code-review.md) — skill · 477 installs
- [prepare-branch-context](https://affpapa.org/en/nevibecode/skills/prepare-branch-context.md) — skill · 107 installs
- [caveman-review](https://affpapa.org/en/nevibecode/skills/caveman-review.md) — skill · 437600 installs
- [check](https://affpapa.org/en/nevibecode/skills/check.md) — skill · 16500 installs
- [commit-hygiene](https://affpapa.org/en/nevibecode/skills/commit-hygiene.md) — skill · 343 installs

From the same set: [ulpi-io/skills](https://affpapa.org/en/nevibecode/by/ulpi-io/skills.md) — 49 cards

---
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
