# Triage Prs

Use this skill to triage the open PR queue before a release.

- Repository: https://github.com/jamiepine/voicebox (59205 stars)
- Category: Design
- License: MIT
- Last updated: 2026-10-07
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add jamiepine/voicebox --skill triage-prs -g -a claude-code -y`
Codex: `npx skills add jamiepine/voicebox --skill triage-prs -g -a codex -y`
Cursor: `npx skills add jamiepine/voicebox --skill triage-prs -g -a cursor -y`
Gemini CLI: `npx skills add jamiepine/voicebox --skill triage-prs -g -a gemini-cli -y`

## Description

Use this skill to triage the open PR queue before a release. Classifies every open PR into must-merge, candidate, superseded, or deferred; writes a working triage doc; and runs the merge loop end-to-end. Designed for the pre-release "PR speedrun" pass where a solo maintainer wants to clear the inbound backlog in a single session.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Triage PRs

## Goal

Turn a backlog of open PRs into a shipped set of merges in a single focused session. Produce a tracked, resumable plan (`<VERSION>_PR_TRIAGE.md`), then work it, rebasing where needed, merging in isolation-safe batches, applying post-merge follow-ups, and closing superseded or partially-applicable PRs with credit to their authors.

This skill pairs with `draft-release-notes` and `release-bump`: triage first, then draft notes against the new main, then cut the release.

## When to use

- Before a minor or major release when 10+ open PRs have accumulated
- When you want to unblock merging without losing the narrative of what's landing
- When you know you can't personally review every PR deeply, but need to land the critical subset fast

## Prerequisites

- `gh` CLI authenticated against the repo
- A dedicated worktree for PR review (avoid contaminating `main` with checkouts of contributor branches)
- Clarity on the target version, the triage doc is named after it (e.g. `0.4.0_PR_TRIAGE.md`)

## Workflow

### 1. Set up an isolated PR-review worktree

```bash
git worktree list  # check for stale ones first
git worktree prune
git worktree add ../voicebox-pr-review -b pr-review-<VERSION> main
```

Keep the main worktree for release-prep work (changelog drafts, direct-to-main follow-ups). Keep the review worktree for `gh pr checkout`, each checkout moves HEAD to a contributor branch, which you don't want to do in the main worktree.

### 2. Gather metadata for every open PR

```bash
gh pr list --state open --limit 50 --json \
  number,title,author,isDraft,mergeable,mergeStateStatus,files,additions,deletions,reviewDecision,statusCheckRollup,maintainerCanModify \
  --jq '.[] | {num: .number, title, author: .author.login, mergeable, state: .mergeStateStatus, canModify: .maintainerCanModify, changes: "+\(.additions)/-\(.deletions)", files: [.files[].path]}'
```

The rest: https://github.com/jamiepine/voicebox/blob/HEAD/.agents/skills/triage-prs/SKILL.md