One-click install
npx skills add https://github.com/docs-plus/docs.plus --skill triage-docs-plus
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: triage
Source: https://github.com/docs-plus/docs.plus/tree/main/.agents/skills/triage
Command: npx skills add https://github.com/docs-plus/docs.plus --skill triage-docs-plus

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually sorting GitHub issues, preparing specifications for autonomous agents, and tracking rejected feature decisions is inconsistent and time-consuming, leading to duplicated work, lost context, and repeated discussions of previously rejected ideas.

Core Features & Use Cases

  • Structured Issue Triage: Enforces a state machine workflow with clear category (bug/enhancement) and state (needs-triage, ready-for-agent, wontfix, etc.) roles to standardize issue sorting.
  • Durable Agent Briefs: Generates compliant agent briefs for AFK agents that avoid stale file/line references and include concrete acceptance criteria.
  • Out-of-Scope Knowledge Base: Manages a persistent record of rejected feature requests to prevent re-litigating past decisions and deduplicate similar incoming issues.
  • Use Case: Open source maintainers can use this skill to quickly sort incoming bug reports and feature requests, prepare well-specified issues for autonomous implementation, and preserve reasoning for rejected features so new contributors don't repeat past discussions.

Quick Start

Use the triage skill to evaluate the 5 newest unlabeled GitHub issues, assign appropriate triage roles, and surface any that match previously rejected feature requests in the .out-of-scope directory.

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 for bug reports and feature requests?

Automating GitHub issue triage involves applying a defined state machine of category and state roles to sort incoming bug reports and feature requests. This standardizes issue workflow by assigning labels like needs-triage or ready-for-agent, preventing duplicated work and lost context.

What is the best way to prepare GitHub issues for autonomous agent implementation?

Preparing GitHub issues for autonomous agents requires generating durable agent briefs with concrete acceptance criteria. This avoids stale file and line references, ensuring AFK agents receive fully specified issues for implementation without losing context or encountering outdated references.

How do I track rejected feature requests to prevent repeated discussions?

Tracking rejected feature requests requires maintaining a persistent out-of-scope knowledge base, such as a .out-of-scope directory. This preserves reasoning for wontfix decisions, preventing new contributors from re-litigating past ideas and deduplicating similar incoming issues.

Does this issue triage workflow support tracking out-of-scope feature decisions?

Yes, this issue triage workflow supports out-of-scope tracking by maintaining a persistent knowledge base of rejected feature requests. It matches incoming issues against previously rejected ideas to prevent re-litigating past decisions and deduplicate similar feature requests.

Can I use a state machine to standardize GitHub issue sorting for open source maintainers?

Yes, you can use a state machine to standardize GitHub issue sorting for open source maintainers. It enforces clear category and state roles, such as needs-triage, ready-for-agent, and wontfix, to consistently sort bug reports and feature requests across the repository.

Why do I need durable agent briefs for AFK autonomous agents?

Durable agent briefs are needed for AFK autonomous agents to avoid stale file and line references during implementation. They include concrete acceptance criteria and fully specified issue context, ensuring autonomous agents can work independently without lost context or duplicated effort.