skills.rest
kashman001
kashman001COMMUNITY
Explore all skills by this author →
GitHub

triage

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

Updated Jun 24, 2026
Search Tags:#issue tracker#pull requests#github issues#triage#backlog management#state machine#agent brief
One-click install
npx skills add https://github.com/kashman001/ai-workspace-template --skill triage-kashman001
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/kashman001/ai-workspace-template/tree/main/skills/triage
Command: npx skills add https://github.com/kashman001/ai-workspace-template --skill triage-kashman001

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Maintainers drown in unstructured issue backlogs: unlabeled reports, vague bug claims, and feature requests that were already rejected. This Skill runs a consistent triage workflow that categorizes issues and PRs, verifies claims against the codebase, and produces durable agent-ready briefs so work can be delegated without re-litigating decisions. ## 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, with conflict detection and maintainer overrides. - Claim verification and deduplication: Reproduces reported bugs, checks out PR diffs, searches the codebase for existing implementations, and matches requests against a .out-of-scope/ knowledge base of prior rejections. - Agent brief authoring: Writes durable, behavioral agent briefs with acceptance criteria and scope boundaries, plus structured needs-info triage notes that preserve resolved context across sessions. - Use Case: A maintainer says "Show me anything that needs my attention" and gets three buckets — unlabeled, needs-triage, and needs-info with new reporter activity — then picks #42, has the bug verified against the codebase, and moves it to ready-for-agent with a complete brief. ## Quick Start Ask the assistant to triage issue #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 skill with a natural language request like "Let's look at #42" or "Show me anything that needs my attention". It reads the full issue, verifies claims against the codebase, 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 spec for an autonomous agent. It describes desired behavior, key interfaces, testable acceptance criteria, and explicit out-of-scope boundaries without referencing file paths or line numbers.

Can triage handle pull requests as well as issues?▼

Yes, external PRs are treated as issues with attached code and move through the same state machine. The skill checks out the diff, runs relevant tests to confirm it does what it claims, and writes briefs scoped to finishing the existing change.

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

Rejected enhancements are recorded as concept files in a .out-of-scope/ directory with the decision, reasoning, and prior request links. During triage, new issues 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?▼

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.

Related Skills

Explore More Software Engineering Skills→
probationer070probationer070

setup-matt-pocock-skills

Configure engineering skills with issue tracker, triage labels, and domain documentation.

Community
Intermediate
noh-rsnoh-rs
142

pull-request

Turn an in-progress code change into a merge-ready GitHub pull request.

Official
Advanced
govoelgovoel
1

grill-with-docs

Validate plans against repository documentation and update CONTEXT.md and ADRs.

Official
Advanced
kvithayathilkvithayathil

github-triage

Automate GitHub issue triage with a label-based state machine.

Community
Advanced