triage

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

Updated Jul 19, 2026
One-click install
npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill triage-dagimalemayehuu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/DagimAlemayehuu/AgenticEngineering/tree/main/agentic-engineering/core/dependencies/github/triage
Command: npx skills add https://github.com/DagimAlemayehuu/AgenticEngineering --skill triage-dagimalemayehuu

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 specification before work can begin. This Skill moves issues through a defined state machine of triage roles so every issue ends up clearly categorized, actionable, and ready for either a human or an autonomous agent. ## Core Features & Use Cases - State machine triage: Classifies issues with one category role (bug or enhancement) and one state role (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix), surfacing anything needing maintainer attention. - Agent brief authoring: Produces durable, behavior-focused agent briefs with concrete acceptance criteria and explicit scope boundaries so AFK agents can execute without stale file-path references. - Out-of-scope knowledge base: Records rejected feature requests in .out-of-scope/ files and matches new issues against prior rejections to avoid re-litigating decisions. - Use Case: A maintainer says "Show me anything that needs my attention" and receives three buckets of unlabeled, in-progress, and reporter-updated issues, then moves issue #42 to ready-for-agent with a complete agent brief posted as a comment. ## Quick Start Ask the assistant to use the triage skill to show which GitHub issues currently need maintainer 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 assistant?▼

Invoke the triage skill with a natural language request such as showing issues needing attention or examining a specific issue number. The skill reads the full issue, recommends a category and state, and applies labels and comments after maintainer 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 do I track rejected feature requests in a repository?▼

Rejected enhancements are recorded as markdown files in a .out-of-scope/ directory, one file per concept, capturing the decision, reasoning, and links to prior requests. During triage, new issues are matched against these files to surface previous rejections before re-evaluating.

Can I move an issue directly to ready-for-agent without full triage?▼

Yes, a maintainer can issue a quick state override such as moving issue #42 to ready-for-agent, and the skill applies the role directly after confirming the planned actions. It will ask whether an agent brief should also be written if no grilling session occurred.

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

The skill attempts reproduction first by tracing code and running tests, and if detail is insufficient it posts triage notes listing what is established and specific questions for the reporter. The issue is labeled needs-info until the reporter responds.