triage

Triage GitHub issues through a state machine enforcing category and state role rules.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It helps teams consistently triage GitHub issues by moving them through clearly defined roles and state transitions, so issues do not stall and agent handoff is well-specified.

Core Features & Use Cases

  • State-machine triage for issues: Categorizes each issue as bug or enhancement and assigns exactly one state role to reflect its current status.
  • Agent-ready handoff with durable briefs: Produces an AFK agent brief contract using AGENT-BRIEF.md when moving an issue to ready-for-agent.
  • Policy-based workflows and overrides: Applies the required disclaimer to triage-generated comments and respects quick overrides from maintainers while flagging conflicting labels.

Real-world use case: when an incoming issue is vague and lacks reproduction details, the maintainer can move it to needs-info, then re-triage it to ready-for-human or ready-for-agent after new information arrives.

Quick Start

Ask an AI to run /triage and show what issues currently need your attention, grouped into unlabeled, needs-triage, and needs-info.

Frequently Asked Questions about triage

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

FAQPage Schema
How does a state machine help triage GitHub issues?

A GitHub issue state machine enforces category and state role rules during triage, ensuring each issue moves through clearly defined states like needs-info or ready-for-agent without stalling. This structured triage maintains consistent status tracking and smooth agent handoff.

How do I prepare GitHub issues for AFK agent execution?

To prepare issues for AFK agent execution, triage them to the ready-for-agent state and generate an agent brief using the AGENT-BRIEF.md contract. This durable brief specifies the exact execution context and requirements for the automated agent.

Can I use quick overrides on GitHub issue labels during triage?

Yes, maintainers can apply quick overrides on issue labels during triage. The state machine respects these manual adjustments while automatically flagging any conflicting labels to prevent invalid state transitions and maintain triage integrity.

How do I handle vague bug reports missing reproduction steps on GitHub?

Move vague bug reports missing reproduction details to the needs-info state during triage. Once the reporter provides the missing information, you can re-triage the issue to ready-for-human or ready-for-agent for further processing.

Does AI-generated triage require a disclaimer on GitHub issue comments?

Yes, triage-generated comments produced by AI must start with a required AI disclaimer. This policy-based workflow ensures transparency by clearly identifying automated responses on GitHub issues during the categorization and state assignment process.

How do I surface out-of-scope decisions when categorizing GitHub issues?

During triage, the state machine surfaces related out-of-scope decisions by referencing the OUT-OF-SCOPE.md file. This prevents duplicate work on rejected features or bugs by checking new issues against previously documented out-of-scope project boundaries.