# pr-retro

The pr-retro skill measures a feature branch against its base and reports merge-readiness with recommendations. Run it before reviewing a PR.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 150 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/pr-retro/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/pr-retro

## What it does

pr-retro gathers Git data for the current branch against its base, including commits, file changes, and branch divergence. It derives branch metrics such as test-code ratio, focus, and change size, then scans the diff for secrets, `.only` markers, conflict markers, and debug code. The result is a `GREEN`, `YELLOW`, or `RED` verdict with recommendations for each signal.

In standard mode, the report also covers contributors, hotspot files, and hygiene findings, and writes a snapshot to `.history/pr-retros/`. With `--quick`, it skips the detailed report and snapshot. The workflow is read-only: it leaves code and Git state untouched, so fixes must be made separately. It stops on `main`, `master`, or `develop`, and requires commits relative to the base branch.

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- judge whether a feature branch is ready to merge
- spot secrets and debug markers in a diff
- check test-code ratio and change size
- identify files where branch changes are concentrated
- get signal-based recommendations before a PR

## Example prompts
- Run `/pr-retro` to assess whether the current branch is ready for a PR.
- Use `/pr-retro --quick` for a short branch check.
- Compare the current branch with `dev` using `/pr-retro --base dev`.

## Similar
- [pr-feedback-quality-gate](https://affpapa.org/en/nevibecode/skills/pr-feedback-quality-gate.md) — skill · 2000 installs
- [full-stop](https://affpapa.org/en/nevibecode/skills/full-stop.md) — skill · 1300 installs
- [antfu-create-pr](https://affpapa.org/en/nevibecode/skills/antfu-create-pr.md) — skill · 919 installs
- [detailed-pr-description](https://affpapa.org/en/nevibecode/skills/detailed-pr-description.md) — skill · 800 installs
- [fix-pr](https://affpapa.org/en/nevibecode/skills/fix-pr.md) — skill · 621 installs
- [ds-ship](https://affpapa.org/en/nevibecode/skills/ds-ship.md) — skill · 534 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
