triage

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

Updated Jul 30, 2026
One-click install
npx skills add https://github.com/j172/bid --skill triage-j172
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/j172/bid/tree/main/agent/skills/triage
Command: npx skills add https://github.com/j172/bid --skill triage-j172

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers lose track of which issues need evaluation, which are waiting on reporters, and which are ready for implementation. This Skill structures issue and PR triage as an explicit state machine so every item gets categorized, verified, and either specified for work or closed with a recorded rationale. ## 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, treating a PR as an issue with attached code. - Verification and grilling: Reproduces reported bugs, checks out PR diffs to confirm claims, and runs structured questioning to flesh out underspecified requests before assigning work. - Agent briefs and out-of-scope records: Writes durable, behavior-focused agent briefs for delegation and maintains a .out-of-scope/ knowledge base so rejected feature requests are never re-litigated. - Use Case: A maintainer asks what needs attention; the Skill lists unlabeled, in-progress, and reporter-replied items, then walks issue #42 through codebase redundancy checks, verification, and a posted agent brief. ## Quick Start Ask the assistant to triage issue #42 on the repository 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 looking at a specific issue number or listing items needing attention. The assistant reads the issue, checks the codebase for existing implementations, verifies claims, and recommends a category and state.

What labels should I use for issue triage workflows?

Use one category label (bug or enhancement) and one state label (needs-triage, needs-info, ready-for-agent, ready-for-human, or wontfix) per issue. The actual label strings can differ from these canonical role names through a configured mapping.

Can triage workflows handle pull requests as well as issues?

Yes, external pull requests are treated as issues with attached code and move through the same states. For a PR, verification means checking out the diff and running relevant tests, and ready-for-agent means an agent should continue work on the existing diff.

What makes a good agent brief for delegating issues?

A good agent brief describes behavioral contracts and acceptance criteria rather than file paths or line numbers, which go stale. It states current behavior, desired behavior, key interfaces, testable criteria, and explicit out-of-scope boundaries.

When should rejected feature requests be recorded?

Record rejected enhancements in an out-of-scope knowledge base file with the decision, reasoning, and links to prior requests. Do not record bugs or features closed because they are already implemented, since those are not rejections.