# Github Triage

Triages a repository's open GitHub issues and pull requests via the gh CLI.

- Repository: https://github.com/trailofbits/skills (7935 stars)
- Category: Git and review
- License: CC-BY-SA-4.0
- Last updated: 2026-10-28
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add trailofbits/skills --skill github-triage -g -a claude-code -y`
Codex: `npx skills add trailofbits/skills --skill github-triage -g -a codex -y`
Cursor: `npx skills add trailofbits/skills --skill github-triage -g -a cursor -y`
Gemini CLI: `npx skills add trailofbits/skills --skill github-triage -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add trailofbits/skills`

## Description

Triages a repository's open GitHub issues and pull requests via the gh CLI. Optionally reviews and merges ready PRs, incrementally merging passing automated/bot PRs and maintainer-approved ones, and spawning review subagents for never-reviewed ones, then closes already-resolved issues with comments citing the resolving PR or commit, cross-links issues with their pending fix PRs, and assigns local-only priority and change-size estimates for everything outstanding. Use when triaging, grooming, or reviewing a repository's open issues and PRs.

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

# GitHub Triage

Triage a repository's open GitHub issues and pull requests. Optionally clear ready
PRs first (merge passing bot PRs and maintainer-approved PRs, review never-reviewed
ones), then close issues that are already resolved (with a comment citing the PR or
commit that resolved them), make sure issues and the pending PRs that fix them
reference each other, and assign a **local-only** priority and change-size estimate
to every issue that is still outstanding.

## When to Use

- When the user runs `/github-triage` to groom or review a repository's open issues
  and pull requests.
- When an issue backlog has drifted: resolved work left open, fixes landed without
  closing their issues, or PRs in flight that never linked their issue.
- When ready PRs have piled up (passing dependency bumps, approved-and-green PRs) or
  PRs are sitting unreviewed.

## When NOT to Use

- Do not invoke automatically. This skill performs irreversible GitHub writes
  (merging PRs, closing issues, posting comments) and runs only on explicit invocation.
- Do not use to apply priority/effort *labels* on GitHub. Priority and size are
  presented locally only and are never posted (see Safety Rules).
- Do not use as a substitute for a human's final merge decision, every merge is
  proposed for explicit approval, never performed autonomously.

## Core Principles

1. **Writes are gated.** Compute the full triage first, present every proposed
   write, merges included, for review, and execute nothing until the user approves.
2. **Evidence before closing.** Never close an issue without a concrete, cited
   reason (a merged PR or a commit on the default branch). When evidence is weak
   or ambiguous, leave the issue outstanding and flag it for review.
3. **Priority and size stay local.** They are an internal planning aid for the
   user, never written to GitHub.

## Workflow

### Phase 0: Select the target repository

The rest: https://github.com/trailofbits/skills/blob/HEAD/plugins/github-triage/skills/github-triage/SKILL.md
