triage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers drown in untriaged issues and external PRs: unclear bug reports, duplicate feature requests, and half-specified work that agents or contributors cannot pick up. This Skill runs a structured triage workflow that categorizes, verifies, and converts raw issues into actionable, agent-ready briefs. ## Core Features & Use Cases - State machine triage: Move issues and external PRs through canonical roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix) with category labels (bug, enhancement). - Verification and grilling: Reproduce reported bugs, check out PR diffs to confirm claims, and run structured questioning rounds to flesh out vague requests before assigning work. - Agent brief generation: Write durable, behavior-focused agent briefs with acceptance criteria and explicit scope boundaries, following the AGENT-BRIEF.md reference. - Out-of-scope knowledge base: Record rejected feature requests in .out-of-scope/ files and surface prior rejections when similar requests reappear. - Use Case: A maintainer says "Let's look at #42". The Skill reads the issue, checks the codebase for existing implementations and prior rejections, verifies the claim, grills the reporter if details are missing, then posts an agent brief and moves the issue to ready-for-agent. ## Quick Start Ask the assistant to triage issue #42 on the repository's issue tracker and move it to the appropriate state.

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 Skill reads the issue, checks the codebase for existing implementations, verifies claims, and 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 this triage workflow handle external pull requests?▼

Yes, external PRs are treated as issues with attached code, using the same roles and states. The Skill checks out the diff, runs relevant tests to confirm the PR does what it claims, and writes briefs describing what remains to finish or fix the existing diff.

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 before re-litigating.

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 uses the same structure but notes why the work cannot be delegated.