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.