triage

Enforce a state-machine workflow for issue triage roles and transitions.

Updated May 7, 2026
One-click install
npx skills add https://github.com/hgxszhj/mattpocock_skills --skill triage-hgxszhj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/hgxszhj/mattpocock_skills/tree/main/skills/engineering/triage
Command: npx skills add https://github.com/hgxszhj/mattpocock_skills --skill triage-hgxszhj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triaging issues often suffers from inconsistency and misalignment between stakeholders. This skill defines a durable, rule-based workflow to classify issues by category and move them through explicit states.

Core Features & Use Cases

  • Stateful triage: Enforces canonical roles (category + state) and predictable transitions.
  • Guided decisions: Surfaced references (AGENT-BRIEF.md, OUT-OF-SCOPE.md) to inform triage outcomes and rejections.
  • Operational workflow: Applies to creating issues, triaging, reviewing bugs or feature requests, and preparing issues for AFK agents.

Quick Start

Invoke the /triage command on an issue to begin triage flow.

Frequently Asked Questions about triage

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

FAQPage Schema
What is a state-machine workflow for software issue triage?

A state-machine workflow for issue triage enforces canonical category and state roles with predictable transitions to classify and move issues through explicit stages. This structured approach ensures consistent governance and alignment when reviewing incoming bugs or feature requests.

How do I triage incoming bugs and feature requests consistently?

Triage incoming bugs and feature requests by applying a rule-based workflow that enforces explicit category and state role transitions. This method uses references like AGENT-BRIEF.md and OUT-OF-SCOPE.md to guide outcomes and standardize the review process.

How do I prepare software issues for AFK agents?

Prepare issues for AFK agents by routing them through a structured triage workflow that defines explicit states and references AGENT-BRIEF.md. This ensures the issue is correctly categorized and contains necessary context before an autonomous agent begins work.

Can I use this triage workflow to reject out-of-scope issues?

Yes, you can reject out-of-scope issues during triage by referencing OUT-OF-SCOPE.md. The state-machine governance model uses this document to inform rejections and ensure only relevant issues move forward in the software engineering pipeline.

What is the best way to enforce governance rules during issue triage?

Enforce governance rules during issue triage by implementing a state-machine workflow that defines explicit category and state roles. This approach standardizes the creation, review, and transition of issues, reducing inconsistency and misalignment between stakeholders.