triage

State machine-driven issue triage with role-based workflow management and agent brief generation.

mattpocock ↓ 424k
Claude Code
View source ↗

What it does

  • AGENT-BRIEF.md — how to write durable agent briefs
  • OUT-OF-SCOPE.md — how the .out-of-scope/ knowledge base works
  • bug — something is broken
  • enhancement — new feature or improvement
  • needs-triage — maintainer needs to evaluate
  • needs-info — waiting on reporter for more information
  • ready-for-agent — fully specified, ready for an AFK agent

Requirements & configuration

  • needs-triage — maintainer needs to evaluate
  • needs-info — waiting on reporter for more information
  • ready-for-human — needs human implementation
  • "Show me anything that needs my attention"
  • Show what needs attention

Configuration: CONTEXT

Derived from the skill's own SKILL.md documentation · extracted 2026-07-23

State machine-driven issue triage with role-based workflow management and agent brief generation.

Source

Repository: https://github.com/mattpocock/skills

triage FAQ

What does the triage skill do?

Move issues and external PRs through a state machine of triage roles — categorise, verify, grill if needed, and write agent-ready briefs. AGENT-BRIEF.md — how to write durable agent briefs OUT-OF-SCOPE.md — how the .out-of-scope/ knowledge base works

What does triage require?

needs-triage — maintainer needs to evaluate needs-info — waiting on reporter for more information ready-for-human — needs human implementation "Show me anything that needs my attention" Show what needs attention Configuration keys: CONTEXT.

How do I install triage?

Run: npx -y skills add https://github.com/mattpocock/skills --skill triage --agent claude-code — the source lives at github.com/mattpocock/skills.

Maintain triage?

Let people know it's listed here — add the badge (live metrics, light/dark aware) or a plain link to your README or docs.

triage on getagentictools
[![triage on getagentictools](https://getagentictools.com/badge/skills/mattpocock-skills-triage.svg)](https://getagentictools.com/skills/mattpocock-skills-triage?ref=badge)
npx agentictools info skills/mattpocock-skills-triage

The second line is the CLI lookup for this page — handy in READMEs and docs.