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.