oss-issue-triage

Designs a sustainable issue and pull-request triage system for open-source maintainer teams.

2|Updated Sep 6, 2026
One-click install
npx skills add https://github.com/samber/developer-relations-skills --skill oss-issue-triage-samber
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: oss-issue-triage
Source: https://github.com/samber/developer-relations-skills/tree/main/skills/oss-issue-triage
Command: npx skills add https://github.com/samber/developer-relations-skills --skill oss-issue-triage-samber

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Open-source issue trackers spiral out of control when incoming reports exceed maintainer capacity and no written policy governs labels, intake, response targets, or closing rules. This Skill turns that chaos into an explicit, capacity-sized triage system a maintainer team can actually sustain. ## Core Features & Use Cases - Capacity-first design: Measures the queue with a baseline script, computes triage capacity against inflow, and derives a publishable first-response target from real numbers rather than ambition. - Full triage system design: Produces a label taxonomy on orthogonal axes, validated intake forms with off-tracker routing, a separate security-report path, a duty rotation with escalation rules, a pull-request gate order, and a closing/staleness policy. - AI-slop and volume gating: Defines a written volume-gating trigger and intake-economics levers for projects drowning in machine-generated reports, without relying on unreliable AI-detection classifiers. - Use Case: A two-person maintainer team with 900 open issues and 35 new issues per week uses this Skill to measure the backlog, consolidate 47 messy labels into a small axis-based set, route usage questions off the tracker, and publish a realistic response policy. ## Quick Start Ask the assistant to design an issue triage process for your repository, starting by measuring the current queue and maintainer capacity.

Frequently Asked Questions about oss-issue-triage

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

FAQPage Schema
How do I design an issue triage process for my open-source project?

Start by measuring the queue with a baseline export of open counts, age, and response times, then compute weekly triage capacity against inflow. From there, design the label taxonomy, intake forms, duty rotation, and closing policy in that order, validating each artifact with the maintainers.

How many labels should a GitHub repository have?

Organize labels into orthogonal axes (type, state, priority, area) with at most one value per axis per item. A solo maintainer needs about four state labels, a small team adds type and a two-value priority, and only multi-owner projects need the six-family Kubernetes-style taxonomy.

Should I use a stale bot to close old GitHub issues?

Only auto-close items waiting on a reporter who stopped replying, never items waiting on maintainers such as confirmed bugs. Restrict the sweep to the waiting-on-reporter state, exempt confirmed and blocked items, warn before closing, and run the first pass in dry-run mode.

How do I handle AI-generated spam issues and security reports?

Gate on reputation and submission volume rather than trying to detect machine-generated content, since no reliable detector exists. Set a written volume-gating trigger in advance, and consider changing submission incentives such as monetary bounties that attract low-quality volume.

What first-response time should an open-source project promise?

Derive the target from measured capacity: triagers times sessions per week times minutes per session, divided by minutes per item, compared against inflow. Publish a number the team can hold in a bad month, defined as a human reply rather than a bot greeting or a fix.

When should security reports leave the public issue tracker?

Always. Security reports need a private intake channel, a named size-capped response team, and an embargo mechanism for coordinated disclosure, separate from general triage. With no security list, use the code host's private vulnerability reporting as the default.