Skip to main content
skill CX Codex

pr-retro — Claude Code skill: branch review and installation

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

no license 150 installs ★ 5 updated 2026-08-31

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add ulpi-io/skills --skill pr-retro -a claude-code
Open on GitHub

What pr-retro 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.

What it helps with

  • 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 for the agent

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

How to install pr-retro

1Skills CLI (Vercel)

npx skills add ulpi-io/skills --skill pr-retro -a claude-code

2Manually: put the files in place

~/.claude/skills/pr-retro/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/pr-retro/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about pr-retro

How do I install pr-retro in Claude Code?

Run npx skills add ulpi-io/skills --skill pr-retro -a claude-code. The skill file is placed at ~/.claude/skills/pr-retro/SKILL.md.

What does pr-retro do?

It derives branch metrics from Git data, scans the diff for pre-PR issues, and returns a merge-readiness verdict with recommendations. It does not modify code or Git state.

Can pr-retro review a branch with no commits against its base?

No. It stops when the current branch is main, master, or develop, or when there are no commits relative to the base branch.

Similar skills

All skills for Git and GitHub →

From the same set49

The whole set →
git-merge-expert-worktree git-merge-expert-worktree — a Claude Code skill that runs merges and conflict resolution inside a dedicated git worktree. The main tree stays clean, and the skill handles its own cleanup when the operation finishes. CX Codex +1 159installs create-pr create-pr opens a GitHub pull request from the real branch diff: commits pending work first, runs the narrowest checks, pushes, then creates and verifies the PR with gh. CX Codex +1 156installs update-skill-learnings update-skill-learnings captures one validated rule about skill design or quality in a central learnings file. Use it when a session reveals guidance worth keeping. CX Codex +1 155installs start start is a Claude Code skill that routes incoming tasks, selects domain skills, evaluates sub-agent delegation, and limits context exploration before code edits. CX Codex +1 152installs ast-grep This skill uses the ast-grep CLI to find code by syntax. Use it when a text or regex search cannot express the structure you need. CX Codex +1 148installs browse-qa browse-qa is a skill that turns feature requests into explicit QA scenarios, runs them through browse, and saves stable flows for regression checks. CX Codex +1 148installs secrets Drives the secrets CLI: add, rotate, list and toggle local service credentials while values stay out of commands and chat. CX Codex +1 148installs run-parallel-agents-feature-debug run-parallel-agents-feature-debug is a Claude Code skill that concurrently diagnoses and fixes three or more independent failures in isolated worktrees after checking for a shared cause. CX Codex +1 148installs

Project sponsors

Companies that keep this analytics open