issue-triage

Assess open GitHub issues and produce an ordered fix plan with per-issue dispositions.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/PeteRichardson/skills --skill issue-triage-peterichardson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-triage
Source: https://github.com/PeteRichardson/skills/tree/main/issue-triage
Command: npx skills add https://github.com/PeteRichardson/skills --skill issue-triage-peterichardson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a repository accumulates many open issues, deciding what to fix first, what to combine into one PR, what to close as moot, and what needs a human decision is manual and error-prone. This Skill analyzes the open issue queue and produces an advisory fix plan instead of a flat ranking. ## Core Features & Use Cases - Relationship graph: Detects file overlap, symbol collisions, declared and semantic dependencies, supersession, and duplicates between issues. - Per-issue dispositions: Assigns WORK, GROUP, CLOSE-MOOT, NEEDS-DECISION, DEFER, STACK, or HOLD to every issue, then orders workable units by dependency, severity, and effort. - Snapshot and label sync: Writes a scoped report under .claude/tmp/issue-triage/ and can sync a status: needs-decision label to GitHub after confirmation. - Use Case: A maintainer with 15 open issues runs a triage to learn that two issues rewrite the same function and should ship as one PR, one is mooted by another fix, and one is blocked on a policy decision. ## Quick Start Ask the assistant to triage the open GitHub issues in this repository and recommend which to fix first, which to group, and which need a decision.

Frequently Asked Questions about issue-triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I triage open GitHub issues and decide what to fix first?

Run the triage against the open issue queue to get a disposition per issue: WORK, GROUP, CLOSE-MOOT, NEEDS-DECISION, or DEFER. Workable units are then ordered by dependency first, severity second, and effort as a tiebreaker.

How to detect GitHub issues that should be combined into one PR?

The skill builds a relationship graph distinguishing file overlap from symbol-level collision. Only issues that change the same function or symbol are grouped into one branch and PR; mere file adjacency is left separate or stacked.

Does issue triage modify or close GitHub issues automatically?

No. A triage run is advisory only: it reads issues and writes a snapshot under .claude/tmp/issue-triage/. The sole mutation is the label subcommand, which syncs one status: needs-decision label after showing changes and getting confirmation.

What tools are required to run GitHub issue triage?

It requires the gh CLI authenticated with read access to the target repository. All analysis uses gh issue list, gh issue view, git log, and reading source files; output goes to a local snapshot directory.

Why group issues by symbol collision instead of file overlap?

Two issues touching the same file may add independent functions, so file overlap alone does not justify merging them. Grouping is reserved for issues rewriting the same function, where separate PRs would conflict by construction.