triage

Classify issues as bug or enhancement and assign a triage state.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/mostafa-K-raihan/skills --skill triage-mostafa-k-raihan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/mostafa-K-raihan/skills/tree/main/triage
Command: npx skills add https://github.com/mostafa-K-raihan/skills --skill triage-mostafa-k-raihan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Move issues on the project issue tracker through a small state machine of triage roles. This Skill defines canonical roles and transitions and provides a repeatable process to prepare issues for AI-assisted or human handling.

Core Features & Use Cases

  • Canonical role and state definitions: category (bug or enhancement) and state (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix).
  • Guided triage workflow: gather context from the issue, make a recommendation, reproduce if needed, grill for missing details, and apply the outcome.
  • Templates and context: surfacing relevant ADRs and prior out-of-scope knowledge to inform triage decisions; supports producing agent briefs or triage notes.
  • Quick example flow: triage an issue to ready-for-agent and generate an agent brief for handoff.

Quick Start

Invoke the /triage command on an issue and follow the guided workflow to classify and advance the issue.

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 with AI to classify bugs and enhancement requests?▼

Triage issues with AI by applying a canonical state machine that assigns a category of bug or enhancement and a state like needs-triage, needs-info, ready-for-agent, ready-for-human, or wontfix based on context from the issue body and comments.

What is the best way to automate issue triage and generate handoff briefs for agents?▼

Automate issue triage by following a guided workflow that evaluates issue context, labels, and prior out-of-scope notes, then posts an agent brief when moving an issue to the ready-for-agent state for AI-assisted handling.

How do I handle issue triage when the reporter provides insufficient information?▼

Handle insufficient issue information by moving the issue to the needs-info state and requesting explicit clarifying questions using a structured template to grill for missing details before proceeding.

Does this AI-assisted triage workflow support referencing past architecture decisions?▼

Yes, the AI-assisted triage workflow surfaces relevant ADRs and prior out-of-scope notes to inform evaluation and surface any prior rejections during the issue classification process.

How do I classify issues that require human intervention rather than automated processing?▼

Classify issues for human intervention by moving them to the ready-for-human state, which automatically produces a justification note explaining the reasoning for the manual handoff.

When should I not use an automated state machine for issue triage?▼

Avoid using an automated state machine for issue triage when an issue lacks sufficient context for classification, instead transitioning it to needs-info to request explicit clarifying details from the reporter.