github-triage

Automate GitHub issue triage using labels and a predefined state machine.

Updated Apr 28, 2026
One-click install
npx skills add https://github.com/dformoso/positronic --skill github-triage-dformoso
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-triage
Source: https://github.com/dformoso/positronic/tree/main/skills/meta/github-triage
Command: npx skills add https://github.com/dformoso/positronic --skill github-triage-dformoso

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) components.

What problem does it solve?

The Skill addresses the challenge of efficiently triaging GitHub issues through an AI-powered state machine, simplifying the process of categorizing and prioritizing bugs and feature requests.

Core Features & Use Cases

  • Label-based State Management: Automatically categorize issues as bugs or enhancements, and assign them to appropriate states such as needs-triage, needs-info, or afk.
  • AI-Driven Recommendations: Provide actionable recommendations based on existing issue data and context.
  • Enhanced Workflow: Streamline the issue management workflow, saving time and reducing errors.

Quick Start

Run the 'github-triage' command and follow the AI's prompts to triage your issues.

Frequently Asked Questions about github-triage

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

FAQPage Schema
How do I automate GitHub issue triage for bug and enhancement categorization?

You can automate GitHub issue triage by using an AI-powered state machine that interprets repository labels and automatically categorizes issues as bugs or enhancements. This streamlines the workflow by assigning appropriate states like needs-triage or needs-info.

What is a state machine approach for managing GitHub issue states?

A state machine approach for GitHub issue states applies predefined rules to interpret existing labels and context. It automatically transitions issues between states like needs-info or afk, providing AI-driven recommendations to reduce manual categorization errors.

Do I need the GitHub CLI to run AI-driven issue categorization?

Yes, you need the GitHub CLI (gh) installed and configured with API access. This dependency allows the AI scripts to interact with your repositories, read issue metadata, and manipulate labels directly.

Can I use AI to recommend states for existing GitHub issues based on labels?

Yes, the AI analyzes existing issue data and label context to offer actionable recommendations for issue states. It evaluates the current repository context to suggest whether an issue should be categorized as a bug or an enhancement.

What are the limitations of using a label-based state machine for issue triage?

A label-based state machine relies entirely on the accuracy of existing repository labels and predefined rules. It may not effectively triage issues with missing context or unlabeled data, requiring manual intervention for ambiguous issue descriptions.