triage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers lose time manually sorting incoming issues and PRs, verifying bug claims, and writing specifications detailed enough for autonomous agents to execute. This Skill standardizes that workflow with a defined state machine and durable brief templates. ## Core Features & Use Cases - State machine triage: Apply category roles (bug, enhancement) and state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) to issues and external PRs. - Verification and grilling: Reproduce reported bugs, check out PR diffs to confirm claims, and grill vague requests into shape using domain-modeling techniques. - Agent brief generation: Write durable, behavior-focused agent briefs with acceptance criteria that survive codebase refactors, plus an .out-of-scope/ knowledge base for rejected features. - Use Case: A maintainer asks what needs attention; the Skill lists unlabeled, in-progress, and replied issues, then walks one issue through verification and posts a complete agent brief so an AFK agent can implement it. ## Quick Start Ask the agent to show everything on the issue tracker that needs triage attention, then pick an issue to evaluate.

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 and describe what you want in natural language, such as showing items needing attention or examining a specific issue number. The skill reads the issue, checks the codebase for existing implementations, and recommends a category and state role.

How do I write a good agent brief for a GitHub issue?▼

An agent brief describes desired behavior rather than implementation steps, avoiding file paths and line numbers that go stale. It must include concrete acceptance criteria, key interfaces to change, and explicit out-of-scope boundaries so an autonomous agent knows when it is done.

Can triage handle pull requests as well as issues?▼

Yes, external pull requests are treated as issues with attached code, using the same roles and state machine. The skill checks out the diff, runs relevant tests to verify claims, and writes briefs describing what remains to finish the PR.

What happens to rejected feature requests during triage?▼

Rejected enhancements are recorded in an .out-of-scope/ directory with the decision, reasoning, and links to prior requests. Future matching issues are surfaced against these files so maintainers can confirm the rejection instead of re-litigating it.

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

Use ready-for-human when the work requires judgment calls, external access, design decisions, or manual testing that an autonomous agent cannot perform. The brief follows the same structure but notes why delegation is not possible.