triage

Triage GitHub issues using a state-machine workflow for AFK agents.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/yarma-tech/agent-admin-qonto --skill triage-yarma-tech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/yarma-tech/agent-admin-qonto/tree/main/.agents/skills/triage
Command: npx skills add https://github.com/yarma-tech/agent-admin-qonto --skill triage-yarma-tech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage management for project issues by applying a compact state-machine of roles to categorize each item (bug or enhancement) and determine the next action, ensuring consistent handling and smoother handoffs to AFK agents.

Core Features & Use Cases

  • State-machine driven triage: classifies issues using category (bug/enhancement) and state (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix), guiding subsequent actions.
  • Agent integration: posts an agent brief when issues reach ready-for-agent and surfaces required guidance from .out-of-scope/ and agent briefs to the triage process.
  • Triage notes and flow: generates structured triage notes, re-asks questions as needed, and supports resuming sessions with prior context from AGENT-BRIEF.md and OUT-OF-SCOPE.md.
  • Reference docs: leverages existing guidance files to ensure consistent decision making during triage.

Quick Start

Invoke the /triage command on an issue and specify the desired outcome to begin triage.

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 for bugs and feature requests?▼

Automating GitHub issue triage involves classifying items as bugs or enhancements and routing them through states like needs-info or ready-for-agent. This Skill uses a state-machine workflow to categorize incoming issues and post agent briefs for consistent handoffs.

What is a state-machine workflow for triaging project issues?▼

A state-machine workflow for triaging issues applies defined states such as needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix to determine next actions. It ensures consistent decision making by transitioning issues between category and state roles.

How do I prepare GitHub issues for an AFK agent?▼

Preparing issues for an AFK agent requires moving them to a ready-for-agent state and generating an agent brief. This Skill surfaces required guidance from OUT-OF-SCOPE.md and AGENT-BRIEF.md to ensure the issue contains all necessary context for the agent.

Can I use this triage workflow to ask follow-up questions on incomplete bug reports?▼

Yes, the triage workflow supports incomplete bug reports by setting issues to a needs-info state. It generates structured triage notes and re-asks questions as needed to gather missing information before proceeding.

How do I resume an issue triage session with prior context?▼

Resuming an issue triage session loads context from existing guidance files like AGENT-BRIEF.md and OUT-OF-SCOPE.md. The workflow restores previous state transitions and triage notes to continue the categorization process seamlessly.

Does this issue triage tool require specific reference docs to function?▼

The issue triage tool leverages existing reference docs like OUT-OF-SCOPE.md and AGENT-BRIEF.md to ensure consistent decision making. It integrates frontmatter from these guidance files to drive the state-machine workflow and agent discovery.