triage

Triage GitHub issues through a state machine of category and state roles.

2|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/Nzettodess/Awesome-Agent-Skills --skill triage-nzettodess
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/Nzettodess/Awesome-Agent-Skills/tree/main/Skills/Engineering%20Skills/skills/engineering/triage
Command: npx skills add https://github.com/Nzettodess/Awesome-Agent-Skills --skill triage-nzettodess

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers of active repositories face a constant stream of incoming bug reports and feature requests that need consistent classification, reproduction, and routing. This Skill moves issues through a structured state machine so every issue ends up properly categorized, specified, and assigned to the right next step. ## Core Features & Use Cases - State machine workflow: Routes issues through needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix states, each paired with a bug or enhancement category. - Agent brief generation: Produces durable, behavior-focused agent briefs with acceptance criteria so AFK agents can implement issues without re-reading stale context. - Out-of-scope knowledge base: Records rejected feature requests in .out-of-scope/ files and surfaces prior rejections when similar requests reappear. - Use Case: A maintainer runs triage on a backlog of 20 unlabeled issues; the Skill reproduces reported bugs, grills ambiguous requests, posts triage notes or agent briefs, and closes duplicates of previously rejected features. ## Quick Start Ask the agent to triage the open issues on your repository and show anything that needs your attention.

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 an AI agent?▼

Invoke the triage command and describe what you want in natural language, such as showing issues needing attention or moving a specific issue to a state. The Skill reads the full issue, recommends a category and state, and applies labels, comments, or closures after your confirmation.

What is an agent brief for GitHub issues?▼

An agent brief is a structured comment posted when an issue moves to ready-for-agent, serving as the authoritative specification for an AFK agent. It describes current and desired behavior, key interfaces, testable acceptance criteria, and explicit out-of-scope boundaries without referencing fragile file paths or line numbers.

How does the triage skill handle rejected feature requests?▼

Rejected enhancements are recorded in .out-of-scope/ markdown files capturing the decision, reasoning, and prior request links. When a similar request arrives later, the Skill surfaces the prior rejection so the maintainer can confirm, reconsider, or proceed with normal triage.

Can I override the triage state machine for a specific issue?▼

Yes, maintainers can issue direct commands like moving an issue to ready-for-agent, and the Skill applies the role immediately after confirming the planned actions. Grilling is skipped in quick overrides, though the Skill asks whether you want an agent brief written.

What happens when a bug report lacks enough detail to reproduce?▼

The Skill attempts reproduction by tracing code and running tests; if detail is insufficient, it recommends the needs-info state. It then posts triage notes listing what is established and specific actionable questions for the reporter.