triage

Move GitHub issues and external PRs through a triage state machine with agent-ready briefs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers of open source projects face a constant stream of unlabeled issues and external pull requests that need categorization, verification, and clear specification before work can begin. This Skill automates that triage workflow, turning raw reports into actionable, agent-ready briefs. ## Core Features & Use Cases - State machine triage: Move issues and PRs through category roles (bug, enhancement) and state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) with consistent labeling. - Verification and grilling: Reproduce reported bugs, validate PR diffs against their claims, and ask reporters targeted questions until requests are fully specified. - Agent brief generation: Write durable, behavior-focused agent briefs with acceptance criteria so AFK agents can implement changes without further human input. - Out-of-scope knowledge base: Record rejected feature requests in .out-of-scope/ files and deduplicate incoming issues against prior rejections. - Use Case: A maintainer runs triage on a backlog of 30 unlabeled issues; the Skill buckets them by attention needed, verifies each bug against the codebase, and posts agent briefs on the ones ready for implementation. ## Quick Start Ask the assistant to show you anything on the issue tracker that needs attention, or name a specific issue number to triage it end to end.

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 workflow in natural language, such as asking what needs attention or naming a specific issue number. The Skill gathers context, verifies claims against the codebase, recommends a category and state, and posts triage notes or an agent brief.

What is an agent brief for GitHub issues?▼

An agent brief is a structured comment posted when an issue reaches ready-for-agent state. It describes current and desired behavior, key interfaces, testable acceptance criteria, and explicit out-of-scope boundaries so an autonomous agent can implement the change.

Can triage handle external pull requests as well as issues?▼

Yes, external PRs are treated as issues with attached code and move through the same roles and states. The Skill additionally checks out the diff and runs relevant tests to confirm the PR does what it claims before recommending a state.

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

Rejected enhancement requests are recorded as concept files in a .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.

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

Use ready-for-human when the work requires judgment calls, external access, design decisions, or manual testing that an autonomous agent cannot perform. The brief follows the same structure but notes why delegation is not possible.