triage

Move issues and external PRs through a triage state machine with categorization and agent-ready briefs.

Updated Jul 20, 2026
One-click install
npx skills add https://github.com/peachest/skills --skill triage-peachest
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/peachest/skills/tree/main/vendor/mattpocock/skills/engineering/triage
Command: npx skills add https://github.com/peachest/skills --skill triage-peachest

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Maintainers of open-source or team projects face a constant stream of unlabeled issues and external pull requests that need evaluation, categorization, and routing. This Skill automates the triage workflow by moving issues and PRs through a defined state machine, verifying claims against the codebase, and producing durable agent-ready briefs. ## Core Features & Use Cases - State machine triage: Route issues and external PRs through category roles (bug, enhancement) and state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) with conflict detection. - Claim verification and grilling: Reproduce reported bugs, check out PR diffs to confirm they work, and run structured questioning rounds to flesh out underspecified requests. - Agent brief generation: Write durable, behavioral agent briefs with acceptance criteria and scope boundaries, plus maintain an .out-of-scope/ knowledge base for rejected feature requests. - Use Case: A maintainer asks "Show me anything that needs my attention" and receives three buckets (unlabeled, needs-triage, needs-info with new reporter activity), then picks issue #42, gets a category and state recommendation backed by codebase checks, and moves it to ready-for-agent with a posted brief. ## Quick Start Ask the agent to triage issue #42 by gathering its context, verifying the claim against the codebase, and recommending a category and state.

Frequently Asked Questions about triage

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

FAQPage Schema
How do I triage GitHub issues with an AI agent?▼

Invoke the triage skill with a natural language request like "Let's look at #42". The skill reads the full issue, checks the codebase for redundancy and prior rejections, verifies the claim, and recommends a category and state role before applying labels and comments.

What is an agent brief for GitHub issues?▼

An agent brief is a structured comment posted when an issue moves to ready-for-agent, serving as the authoritative spec for an AFK agent. It describes desired behavior, key interfaces, testable acceptance criteria, and explicit out-of-scope boundaries without referencing fragile file paths or line numbers.

Can triage handle external pull requests as well as issues?▼

Yes, when the issue tracker config treats external PRs as a request surface, a PR is triaged as an issue with attached code using the same roles and states. The skill additionally checks out the diff and runs relevant tests to confirm it does what it claims.

How does the .out-of-scope directory prevent duplicate feature requests?▼

Rejected enhancement requests are recorded as concept files in .out-of-scope/ with the decision, reasoning, and prior issue links. During triage, new issues are matched against these files by concept similarity so prior rejections are surfaced instead of re-litigated.

When should an issue go to ready-for-human instead of ready-for-agent?▼

Use ready-for-human when the work cannot be delegated to an agent, such as judgment calls, external access requirements, design decisions, or manual testing. The skill posts the same brief structure but notes why human implementation is required.