One-click install
npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill triage-kileroppo
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/kileroppo/AI-Coding-Guidance-Skills/tree/main/skills/triage
Command: npx skills add https://github.com/kileroppo/AI-Coding-Guidance-Skills --skill triage-kileroppo

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps maintainers efficiently route GitHub issues through a clear triage workflow, reducing unanswered questions and speeding up delivery by ensuring the right issues reach the right owners.

Core Features & Use Cases

  • State-machine triage workflow: Categorizes issues as either bug or enhancement, assigns exactly one state role, and moves issues through transitions like needs-triage, needs-info, ready-for-agent, ready-for-human, or wontfix.
  • AFK-agent readiness with durable briefs: Produces an agent brief that specifies acceptance criteria and scope boundaries using a stable template designed to remain valid as the codebase evolves.
  • Institutional memory for rejected enhancements: Checks the .out-of-scope/ knowledge base for prior rejections and routes new enhancement requests appropriately, including writing/annotating .out-of-scope/ entries when wontfix is decided.
  • Use case: When an issue like “Login fails sometimes after password reset” arrives, the Skill can help determine whether it’s a bug or enhancement, gather missing details, and prepare a ready-for-agent brief if it’s sufficiently specified.

Quick Start

Ask the maintainer to run triage for a specific issue number, for example: "Triaged issue #42—decide the category and move it to ready-for-agent if it is ready, otherwise request the missing information."

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 route bugs to the right resolution path?

Automating GitHub issue triage involves categorizing issues as bug or enhancement, assigning a state role like needs-info or ready-for-agent, and moving them through a state-machine workflow to route them to the correct owner or AFK agent for resolution.

What's the best way to prepare a GitHub issue for an automated agent implementation?

To prepare a GitHub issue for an automated agent, you generate a durable agent brief that specifies acceptance criteria and scope boundaries, ensuring the issue is fully scoped and assigned the ready-for-agent state role before handoff.

How does the .out-of-scope knowledge base work for rejected enhancement requests?

The .out-of-scope knowledge base provides institutional memory by storing prior enhancement rejections. When a new request arrives, the triage workflow checks this knowledge base to route it appropriately or annotates a new entry when a wontfix decision is made.

Can I enforce exactly one category and one state role when triaging GitHub issues?

Yes, the triage workflow enforces canonical role naming by ensuring exactly one category, either bug or enhancement, and exactly one state role, such as needs-triage, needs-info, ready-for-agent, ready-for-human, or wontfix, is assigned to each issue.

Do I need to add a disclaimer when posting automated triage comments on GitHub?

Yes, the triage workflow requires adding a specific triage disclaimer to all generated comments posted on GitHub issues, ensuring transparency that the categorization and state role assignment were produced by an automated process.

Why should I use a state machine for bug reporting and enhancement scoping instead of manual labels?

Using a state machine for bug reporting and enhancement scoping reduces unanswered questions and speeds up delivery by applying consistent transitions like needs-triage to ready-for-agent, ensuring issues reach the right owners without manual sorting errors.