triage

Categorize GitHub issues and transition them through a triage state machine.

1|1|Updated Feb 4, 2026

Search Tags:#workflow automation #state management #GitHub #issue triage #issue lifecycle

Ready to run

npx skills add https://github.com/arxxyr/dotfiles --skill triage-arxxyr

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/arxxyr/dotfiles/tree/main/dot_agents/skills/triage
Command: npx skills add https://github.com/arxxyr/dotfiles --skill triage-arxxyr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a structured process for triaging GitHub issues, improving workflow efficiency and clarity by categorizing and directing issues through a state machine.

Core Features & Use Cases

Issue Categorization: Automatically categorize issues as bugs or enhancements, and further state them as needing information, ready for agents, ready for human review, or not fixable.
State Management: Track the lifecycle of issues through states like 'needs-triage', 'ready-for-agent', and 'wontfix', with clear transitions.
Automated Briefing: Generate detailed agent briefs and out-of-scope documentation for efficient issue handling.

Quick Start

Initialize the triage system by running the '/triage' command in your GitHub issue tracker.

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 and categorize bugs versus enhancements?▼

Automate GitHub issue triage by running the '/triage' command to process issues through a state machine that categorizes them as bugs or enhancements. It transitions issues into states like needing information, ready for agents, ready for human review, or not fixable.

How does issue state management work for tracking the GitHub issue lifecycle?▼

Issue state management tracks the lifecycle of GitHub issues through explicit states like 'needs-triage', 'ready-for-agent', and 'wontfix' with clear transitions. This ensures issues move systematically from initial review to final resolution based on their current status.

Can I generate agent briefs for ready-for-agent issues in GitHub?▼

Yes, you can generate agent briefs for issues in the ready-for-agent state. The triage system generates detailed agent briefs and out-of-scope documentation to provide context for efficient issue handling.

Do I need GitHub integration to categorize and transition issue statuses?▼

Yes, GitHub integration is required to categorize and transition issue statuses. The triage system relies on understanding GitHub issue tracking workflows to direct issues through its state machine.

What is the best way to streamline issue categorization for wontfix and needs-triage states?▼

The best way to streamline issue categorization is using a state machine to transition issues into states like 'needs-triage' and 'wontfix'. This structured process provides workflow efficiency and clear categorization for actionable steps.