triage

Orchestrate GitHub issue triage with role-based state transitions and agent briefs.

5|Updated May 21, 2026
One-click install
npx skills add https://github.com/TrebuchetDynamics/pi-package-goal --skill triage-trebuchetdynamics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/TrebuchetDynamics/pi-package-goal/tree/main/skills/triage
Command: npx skills add https://github.com/TrebuchetDynamics/pi-package-goal --skill triage-trebuchetdynamics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Triage coordination for GitHub issues becomes consistent, auditable, and faster by guiding maintainers through a role-based state machine and the exact required outputs during workflow transitions.

Core Features & Use Cases

  • Issue workflow state machine: Moves issues across canonical triage roles (category + state) such as needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix.
  • AFK agent-ready preparation: Produces agent briefs using a durable contract format so an AFK agent can work without relying on stale file paths or line numbers.
  • Rejection knowledge base support: Writes/links to .out-of-scope concept records for enhancement wontfix decisions to enable deduplication and institutional memory.
  • Guided context gathering and recommendations: Reads issue details, existing notes, relevant repo docs, and prior triage to recommend the next role transition with supporting codebase context.

Quick Start

Use the triage skill to move an issue to ready-for-agent by requesting: "Move issue #42 to ready-for-agent and write the agent brief."

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?

GitHub issue triage automation uses a role-based state machine to recommend and apply category and state label transitions. It guides issues through canonical roles like needs-triage, needs-info, ready-for-agent, ready-for-human, and wontfix.

Can I prepare GitHub issues for an AFK agent with durable context?

Yes, preparing GitHub issues for an AFK agent involves producing agent briefs using a durable contract format. This ensures the AFK agent can work without relying on stale file paths or line numbers.

What is the best way to record wontfix decisions for enhancement requests?

Recording enhancement wontfix decisions requires writing or linking to .out-of-scope concept records. This builds a rejection knowledge base that enables deduplication and preserves institutional memory.

How does issue triage gather context before recommending label transitions?

Issue triage gathers context by reading issue details, existing notes, relevant repo docs, and prior triage history. It uses this context to recommend the next role transition with supporting codebase evidence.

Does the triage workflow enforce formatting rules for AI-generated comments?

Yes, the triage workflow enforces durable agent-brief formatting requirements and disclaimer rules for AI-generated triage comments. It also mandates structured acceptance-criteria-driven outputs for ready states.

When should I use a structured state machine for GitHub label management?

A structured state machine for GitHub label management is needed when triage coordination must be consistent, auditable, and faster. It guides maintainers through exact required outputs during workflow transitions.