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.