triage

Moves issues through a triage state machine using category and state roles.

138|6|Updated Jan 25, 2025
One-click install
npx skills add https://github.com/yamcodes/arkenv --skill triage-yamcodes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/yamcodes/arkenv/tree/main/skills/triage
Command: npx skills add https://github.com/yamcodes/arkenv --skill triage-yamcodes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage issues through a state machine driven by triage roles. The process guides classification, evaluation, and progression of issues from creation through resolution, ensuring consistent handling across bugs and enhancements and enabling seamless preparation for AFK agents or human review.

Core Features & Use Cases

  • Defined roles: two category roles (bug, enhancement) and five state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) plus one exempt role (meta) to govern triage workflows.
  • State-driven workflows: enforce transitions between triage states with clear acceptance criteria and escalation paths.
  • Reference guidance: leverages agent briefs and out-of-scope documentation to surface decisions and ensure durable triage decisions.
  • Governance integration: supports automation hooks to generate agent briefs for ready-for-agent tasks and surface decisions for human review when needed.

Quick Start

Invoke /triage and describe what you want to do in natural language.

Frequently Asked Questions about triage

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

FAQPage Schema
How do I automate GitHub issue triage with a state machine?

You can automate GitHub issue triage by applying a deterministic state machine that moves issues through defined roles like needs-triage, needs-info, ready-for-agent, and wontfix based on category. This ensures consistent classification and progression for bugs and enhancements.

What is a deterministic triage workflow for issue tracking?

A deterministic triage workflow is a state-driven process that governs issue lifecycles using category roles (bug, enhancement) and state roles (needs-triage, ready-for-human). It enforces clear transitions with acceptance criteria to guide issues from creation through resolution.

Can I prepare GitHub issues for AFK agents automatically?

Yes, you can prepare issues for AFK agents by transitioning them to the ready-for-agent state. The workflow generates agent briefs and leverages out-of-scope documentation to ensure the automated agent has clear guidance on the task.

Does this issue triage workflow support both bug reports and feature requests?

Yes, the triage workflow explicitly supports both bug and enhancement category roles. It applies defined state transitions and evaluation criteria to ensure both types of issues are consistently triaged and prepared for either human review or AFK agents.

How do I handle issues that lack information during GitHub triage?

Issues lacking information are moved to the needs-info state within the triage state machine. This dedicated state enforces a pause in progression until the required details are provided, ensuring incomplete issues do not reach human or agent workflows.

What is the best way to manage ongoing issue lifecycles and wontfix decisions?

Managing ongoing issue lifecycles is best handled through a triage state machine that includes a wontfix state for closure and an exempt meta role for governance. This approach surfaces decisions durably and enforces clear escalation paths for human review.