triage

Assign category and state roles to GitHub issues via a state-machine workflow.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you consistently organize GitHub issues by evaluating them, requesting missing info, and routing them to the right next step for agents or humans.

Core Features & Use Cases

  • State-machine triage for issue labels: Assign exactly one category role (bug or enhancement) and one state role (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix).
  • Context gathering and documentation: Read full issue details and prior triage notes, and consult the out-of-scope knowledge base to avoid re-litigating past decisions.
  • Agent-ready output: Produce durable, acceptance-criteria-driven agent briefs (or a human-ready equivalent) based on what the issue needs next.

Quick Start

Ask the maintainer AI to triage an issue by running /triage and specifying the issue number, for example: move #42 to ready-for-agent.

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 and labeling?

A state-machine workflow assigns exactly one category and one state role to each GitHub issue. It automates triage by evaluating new issues, requesting missing information, and routing items to agents or humans via durable briefs.

How do I request more information on a GitHub bug report?

Assign the needs-info state role to the GitHub issue. The triage workflow flags the bug report, requests missing details from the submitter, and pauses further processing until enough information is provided.

Can I automatically close out-of-scope enhancement requests?

Yes, the triage workflow assigns the wontfix state role to out-of-scope enhancement requests. It consults an out-of-scope knowledge base to document the decision and prevent re-litigating past rejections.

What is an AFK agent brief in GitHub issue routing?

An AFK agent brief is a durable, acceptance-criteria-driven output generated during bug triage. It packages reproduced issues with structured context so an asynchronous agent can begin work immediately without human intervention.

Does this bug triage workflow support both human and automated routing?

Yes, the triage workflow supports both paths by assigning ready-for-agent or ready-for-human state roles. It generates durable agent briefs or human-ready equivalents based on what the issue requires next.