happier-issue-triage

Cluster and route GitHub issues into coherent diagnosis bundles.

1.6k|141|Updated Dec 16, 2025
One-click install
npx skills add https://github.com/happier-dev/happier --skill happier-issue-triage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: happier-issue-triage
Source: https://github.com/happier-dev/happier/tree/main/skills/happier-issue-triage
Command: npx skills add https://github.com/happier-dev/happier --skill happier-issue-triage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Maintainers facing a backlog of GitHub issues struggle to decide which reports belong together, which are duplicates, and who should diagnose each group. This Skill turns a raw issue set into evidence-backed, decision-coherent bundles with clear routing before any deep diagnosis begins.

Core Features & Use Cases

  • Corpus retrieval and normalization: Batch-fetch compact issue metadata, treat public issue content as untrusted evidence, and normalize claims, version vectors, and report quality for each issue.
  • Relationship and bundle analysis: Find evidence-backed relationships (duplicates, shared mechanisms, regression lineage) using stable signatures like errors, routes, and symbols, then group issues into independently diagnosable bundles.
  • Routing and topology selection: Route each bundle to the main lane, native subagents, or independent Happier sessions, while keeping GitHub mutations separate and gated behind explicit authorization.
  • Use Case: A maintainer asks to triage 30 open bug reports; the Skill fetches compact metadata, clusters them into four coherent bundles by likely mechanism, flags two duplicate candidates, and proposes a routing plan with version gaps and missing evidence.

Quick Start

Ask the assistant to triage a set of Happier GitHub issues by URL, label, or query and group them into diagnosis bundles with routing recommendations.

Frequently Asked Questions about happier-issue-triage

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

FAQPage Schema
How do I triage multiple GitHub issues at once?

Provide the issue set as URLs, numbers, a query, label, or milestone, and the Skill batch-fetches compact metadata first, then deep-fetches only relevant issues. It normalizes each report, finds evidence-backed relationships, and outputs a bundle map with routing recommendations.

How does the Skill decide which GitHub issues are duplicates?

Duplicate candidates require semantic equivalence of the user-visible contract, not keyword similarity. The Skill compares stable signatures like errors, routes, commands, and symbols, and preserves distinct issues when one is narrower, broader, or has independent acceptance criteria.

Can the triage Skill apply labels or close issues on GitHub?

Triage is read-only by default and only proposes labels, comments, or state changes. Mutations are applied solely through the exact or bounded standing authorization defined in the happier-github-ops skill, with full payload previews under exact authorization.

When should I use native subagents versus independent Happier sessions?

Use native subagents when you want one consolidated answer in the current session, with the parent verifying and reconciling results. Use independent Happier sessions when you want separate durable conversations, each owning one coherent maintainer decision.

Does the triage Skill diagnose root causes of issues?

No, triage only routes work; deep diagnosis is delegated to the happier-issue-diagnose skill. Triage inspects source just enough to test plausibility and locate candidate owners without proving root cause.