triage

Classify project issues into categories and states for triage workflows.

1|Updated May 20, 2025
One-click install
npx skills add https://github.com/vessux/dotfiles --skill triage-vessux
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/vessux/dotfiles/tree/main/umbel/skills/pocock/triage
Command: npx skills add https://github.com/vessux/dotfiles --skill triage-vessux

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Triage of issues in software projects is often inconsistent and slow. This Skill provides a durable, rule-based approach that standardizes how issues are categorized and advanced through a defined state machine, reducing ambiguity and turnaround time.

Core Features & Use Cases

  • Canonical roles: two category roles (bug and enhancement) and five state roles (needs-triage, needs-info, ready-for-agent, ready-for-human, wontfix)
  • Enforced state transitions with clear guidance to ensure consistent triage across issues
  • Handoff support for AFK agents through generation of agent briefs and triage notes

Quick Start

Invoke the /triage command on an issue to classify and move it through the triage workflow.

Frequently Asked Questions about triage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate GitHub issue triage with a state machine?

Automate GitHub issue triage by assigning a canonical category and state to each issue. This workflow enforces strict state transitions across five states like needs-info and ready-for-agent to reduce ambiguity and turnaround time.

What is the best way to standardize new issue intake for software projects?

Standardize new issue intake by classifying issues into bug or enhancement categories and routing them through a defined state machine. This ensures consistent triage discussions and prepares issues for autonomous handoff.

How do I generate agent briefs for AFK agents from GitHub issues?

Generate agent briefs for AFK agents by advancing issues to the ready-for-agent state. The triage workflow enforces this state transition and produces triage notes to support autonomous handoff.

Can I enforce specific state transitions when routing project issues?

Yes, you can enforce specific state transitions when routing project issues. The triage workflow applies strict state machine rules across five canonical states to ensure consistent and durable issue advancement.

How does issue triage classification work for autonomous agents?

Issue triage classification assigns a single category and a state to each issue. This rule-based approach drives autonomous triage by generating agent briefs and triage notes for AFK agents to process.

When should I move a GitHub issue to the needs-info state during triage?

Move a GitHub issue to the needs-info state during triage when further clarification is required. This state is part of a five-state workflow designed to standardize issue routing and ongoing triage discussions.