triage

Triage GitHub issues through a label-driven state machine with agent briefs.

Updated Aug 17, 2026
One-click install
npx skills add https://github.com/prabaljainn/my-claude-code-setup --skill triage-prabaljainn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/prabaljainn/my-claude-code-setup/tree/main/agents/skills/triage
Command: npx skills add https://github.com/prabaljainn/my-claude-code-setup --skill triage-prabaljainn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers of open-source or team projects face a constant stream of unstructured bug reports and feature requests. This Skill moves issues through a consistent triage workflow—classification, reproduction, clarification, and handoff—so every issue ends up with a clear category, state, and actionable specification instead of languishing unlabeled. ## Core Features & Use Cases - State machine triage: Moves issues through canonical roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) paired with bug or enhancement categories, with maintainer override support. - Agent brief generation: Produces durable, behavior-focused agent briefs with acceptance criteria so AFK agents can implement issues without re-reading stale discussion threads. - Out-of-scope knowledge base: Records rejected feature requests in .out-of-scope/ files and surfaces prior rejections when similar requests reappear, preventing re-litigation. - Use Case: A maintainer runs triage on a backlog of 30 unlabeled issues; the Skill buckets them by attention needed, reproduces reported bugs, grills reporters for missing detail, and posts ready-to-implement briefs on the actionable ones. ## Quick Start Ask the assistant to triage issue number 42 and recommend a category and state with reasoning.

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 assistant?▼

Invoke the triage workflow in natural language, such as asking to look at a specific issue or show everything needing attention. The assistant reads the full issue, recommends a category and state, and applies labels and comments after your confirmation.

What is an agent brief for GitHub issues?▼

An agent brief is a structured issue comment that serves as the authoritative specification for an autonomous coding 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 out-of-scope knowledge base prevent duplicate feature requests?▼

Rejected enhancements are recorded as concept files in a .out-of-scope/ directory with the decision, reasoning, and links to prior requests. During triage, new issues are matched against these files by concept similarity, and prior rejections are surfaced to the maintainer.

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

Yes, maintainers can issue direct commands like moving an issue straight to ready-for-agent. The assistant confirms the role changes, comments, and closures before acting, and skips the grilling step when you give an explicit override.

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

The assistant attempts reproduction first by tracing code and running tests. If detail is insufficient, it posts structured triage notes listing what is established and specific actionable questions for the reporter, then applies the needs-info state.