triage

Triage project tracker issues with a state-machine workflow enforcing one category and state.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage issues on the project tracker by applying a durable, rule-driven workflow that clarifies responsibilities and routing decisions, reducing miscommunication and triage time.

Core Features & Use Cases

  • Enforces one category and one state per triaged issue to eliminate ambiguity.
  • Provides clear state transitions (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) and guidance for each.
  • Useful for creating issues, triaging incoming bugs or feature requests, preparing issues for an AFK agent, and managing overall issue workflow.

Quick Start

Invoke /triage on an issue to begin the guided triage workflow.

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 using a deterministic state machine?

You can triage GitHub issues by invoking the triage workflow, which enforces exactly one category and one state per issue and defines explicit state transitions to eliminate ambiguity and reduce triage time.

What states are used when triaging incoming bugs and feature requests?

The states used when triaging incoming bugs and feature requests are needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix, with clear guidance provided for each state transition.

How do I prepare GitHub issues for an AFK agent?

To prepare issues for an AFK agent, the triage workflow transitions items to the ready-for-agent state, ensuring all necessary information is reviewed and categorized so the agent can process it autonomously.

Does this issue triage workflow require any specific dependencies or components?

No specific dependencies or components are required to use this issue triage workflow, meaning it can be applied directly to a project tracker without additional package installations or environment setup.

Why use a deterministic state machine for issue workflow instead of manual sorting?

A deterministic state machine clarifies responsibilities and routing decisions for issue workflow, reducing miscommunication and triage time by enforcing exactly one category and one state per triaged item, unlike manual sorting.

Can I create new issues directly within the triage workflow?

Yes, the triage workflow is useful for creating issues, triaging incoming bugs or feature requests, reviewing them, and preparing them for AFK agents, managing the overall issue workflow from creation onward.