triage

Assess issues and pull requests, verify claims, and prepare actionable implementation briefs.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Issue trackers accumulate unverified bug reports, duplicate requests, and ambiguous feature asks that stall maintainers. This Skill verifies claims against the actual code, applies the project's existing workflow labels, and turns raw requests into actionable next states or implementation briefs. ## Core Features & Use Cases - Claim Verification: Reproduces bug reports or inspects relevant code before confirming issues, and checks whether requested behavior already exists or was previously rejected. - State Management: Maps items to existing workflow states like needs-triage, needs-info, ready-for-agent, or wontfix without inventing new labels. - Implementation Briefs: Produces structured briefs with acceptance criteria, scope boundaries, and contract pointers for ready items, plus rejection records for out-of-scope requests. - Use Case: A maintainer points the agent at an open GitHub issue; the Skill reproduces the reported bug, confirms it, applies the ready-for-agent label, and drafts a brief a contributor can implement from directly. ## Quick Start Triage issue number 42 in this repository, verify the reported bug, and prepare an implementation brief if it is confirmed.

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?

Point the agent at an issue identifier and it inspects the full request, replies, and prior triage notes. It verifies bug claims by reproducing them or reading the code, then recommends or applies the appropriate workflow state using the project's existing labels.

How to verify a bug report before labeling it confirmed?

Reproduce the reported behavior or inspect the relevant code paths before applying any confirmation label. The Skill separates confirmed observations from assumptions and only asks reporters for information that blocks a reliable next step.

Can it triage pull requests as well as issues?

Yes, it resolves whether a supplied identifier names an issue or PR before acting. For pull requests it includes the diff in its review, describing what the diff already provides and the remaining gaps rather than requesting a full rebuild.

What is an implementation brief for a ready issue?

An implementation brief captures the request and evidence, current and desired behavior, relevant contracts and code pointers, acceptance criteria, and scope exclusions. It lets a fresh contributor verify and implement the request without reconstructing the original conversation.

When should a feature request be recorded as out of scope?

Record a rejection only for explicit scope decisions, not for already-implemented behavior or merely deferred work. If the project maintains a decision record, match requests by concept and append to existing decisions rather than creating per-issue files.

Does triage automatically close or comment on issues?

No, an explicit state-change request authorizes only that specific change, not unrelated comments or closures. For read-only triage it reports the recommended state and evidence without modifying the tracker.