triage

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

7|1|Updated Jul 17, 2026
One-click install
npx skills add https://github.com/J0Jng/MathModelingAgents --skill triage-j0jng
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/J0Jng/MathModelingAgents/tree/main/.claude/skills/engineering/triage
Command: npx skills add https://github.com/J0Jng/MathModelingAgents --skill triage-j0jng

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers drown in unlabeled issues and half-specified feature requests, and AFK coding agents receive vague tickets they cannot act on. This Skill runs a structured triage workflow that categorizes issues, verifies claims against the codebase, and produces durable agent briefs. ## Core Features & Use Cases - State machine triage: Applies category roles (bug, enhancement) and state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) to issues and external PRs. - Codebase verification: Reproduces reported bugs, checks out PR diffs to confirm claims, and detects already-implemented features or prior rejections via the .out-of-scope/ knowledge base. - Agent brief authoring: Writes durable, behavior-focused briefs with acceptance criteria and explicit scope boundaries that survive codebase refactors. - Use Case: A maintainer says "Let's look at #42" — the Skill reads the issue, checks the codebase for redundancy, verifies the bug, grills the reporter if details are missing, and posts an agent-ready brief. ## Quick Start Ask the assistant to triage issue #42 and move it to the appropriate state with an agent brief.

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 like "show me anything that needs my attention" or "let's look at #42". The assistant reads the issue, checks the codebase for redundancy and prior rejections, then recommends a category and state before applying labels and comments.

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 autonomous coding agent. It describes desired behavior, key interfaces, testable acceptance criteria, and explicit out-of-scope boundaries without referencing fragile file paths or line numbers.

Can triage handle pull requests as well as issues?▼

Yes, external pull requests are treated as issues with attached code and move through the same state machine. The assistant checks out the diff, runs relevant tests to verify claims, and writes briefs describing what remains to be finished on the existing code.

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 requests are matched against these files by concept similarity so prior rejections are surfaced instead of re-litigated.

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.