triage

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

Updated May 12, 2026
One-click install
npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill triage-eduardtomasek
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/eduardtomasek/codex-dev-stack/tree/main/skills/.agents/triage
Command: npx skills add https://github.com/eduardtomasek/codex-dev-stack --skill triage-eduardtomasek

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers of open-source or team projects 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 structured triage state machine so every issue ends up with a clear category, state, and actionable specification. ## Core Features & Use Cases - State machine triage: Classify issues with category roles (bug, enhancement) and state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix), with conflict detection and maintainer overrides. - Agent brief generation: Produce durable, behavior-focused agent briefs with acceptance criteria and scope boundaries so AFK agents can implement issues without re-reading stale discussions. - Out-of-scope knowledge base: Record rejected feature requests in .out-of-scope/ files and surface prior rejections when similar requests reappear, preventing re-litigation. - Use Case: A maintainer runs triage on a backlog of 20 unlabeled issues; the Skill buckets them by attention needed, reproduces reported bugs, grills reporters for missing detail, and posts ready-for-agent 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 with a natural language request such as showing issues needing attention or examining a specific issue number. The assistant reads the full issue, explores the codebase, 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 comment posted when an issue moves to ready-for-agent, describing current behavior, desired behavior, key interfaces, acceptance criteria, and out-of-scope items. It avoids file paths and line numbers so it stays valid as the codebase changes.

How does the out-of-scope knowledge base prevent duplicate feature requests?▼

Rejected enhancements are recorded as concept files in an .out-of-scope/ directory with the decision, reasoning, and prior issue links. 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 to ready-for-agent, and the assistant applies the role change after confirming the actions. Unusual transitions are flagged for confirmation before proceeding.

When should an issue go to ready-for-human instead of ready-for-agent?▼

Issues requiring judgment calls, external access, design decisions, or manual testing go to ready-for-human. The brief uses the same structure as an agent brief but notes why the work cannot be delegated to an autonomous agent.