triage
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
- Kind
- Skill
- Works with
- Claude Code
- Source
- mattpocock/skills @ 24fe0ef7737e
- Path
- skills/engineering/triage/SKILL.md
- License
- MIT
- Jobs
- Planning, Review
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# Triage Move issues on the project issue tracker through a small state machine of triage roles. If this repo treats external pull requests as a request surface (see the issue-tracker config), triage covers them too: **a PR is an issue with attached code**, using the same roles, same states, and same machine, with a few deltas marked "for a PR" below. Resolve a bare `#42` to an issue or PR per the tracker config. Every comment or issue posted to the issue tracker during triage **must** start with this disclaimer: ``` > *This was generated by AI during triage.* ``` ## Reference docs - [AGENT-BRIEF.md](AGENT-BRIEF.md): how to write durable agent briefs - [OUT-OF-SCOPE.md](OUT-OF-SCOPE.md): how the `.out-of-scope/` knowledge base works ## Roles Two **category** roles: - `bug`: something is broken - `enhancement`: new feature or improvement Five **state** roles: - `needs-triage`: maintainer needs to evaluate - `needs-info`: waiting on reporter for more information - `ready-for-agent`: fully specified, ready for an AFK agent - `ready-for-human`: needs human implementation - `wontfix`: will not be actioned …