happier-issue-diagnose

Diagnose GitHub issue bundles with evidence-backed root cause and disposition.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Maintainers of the Happier project receive GitHub issues that mix raw user reports, pre-diagnosed engineering claims, private diagnostics, and linked pull requests. This Skill establishes what is actually true about an issue bundle—root cause, affected versions, and justified response—before any fix or GitHub mutation happens.

Core Features & Use Cases

  • Evidence-based diagnosis: Classifies reports, builds a minimal factual issue record, resolves private diagnostics through maintainer tooling, and traces the causal chain to the canonical code owner.
  • Version and release provenance: Distinguishes reported, source, loaded, fix, and release bases so claims like "fixed" or "regression" are tied to named artifacts rather than assumptions.
  • Linked PR assessment: Evaluates linked pull requests against the independently verified issue contract in read-only advisory mode, flagging partial, wrong-owner, or obsolete fixes.
  • Use Case: A maintainer points the Skill at issue #210; it reproduces the defect on the reported release, identifies the owning component, confirms the fix exists on dev but not in any shipped artifact, and proposes a stage:source label plus a reporter-facing comment.

Quick Start

Use the happier-issue-diagnose skill to investigate GitHub issue #123 and tell me the verified root cause, affected versions, and recommended response.

Frequently Asked Questions about happier-issue-diagnose

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

FAQPage Schema
How do I diagnose a GitHub issue before writing a fix?

Classify the report type, build a minimal factual record of observed versus expected behavior, reproduce on the reported version, and trace the failure to its canonical code owner. This Skill enforces that read-only workflow and outputs an evidence-backed disposition.

How do I verify whether a bug is fixed in a released version?

Compare the reported version vector against the fix commit and the first immutable released artifact proven to contain it. Source containing a fix is not proof users received it; the Skill's version-and-status reference defines the required provenance basis.

Can this Skill edit code or close GitHub issues?

No. Diagnosis is strictly read-only: it cannot edit source, mutate GitHub state, or run destructive operations. Implementation requires separate user authorization handed to the happier-implement skill, and GitHub writes require explicit authority through happier-github-ops.

How are private diagnostic attachments handled during issue triage?

Private diagnostics are fetched only through maintainer tooling such as bounded MCP tools or hmaint commands, inspecting excerpts before downloading. Raw private evidence is never published, and unavailable credentials are recorded as an explicit limitation.

When should a linked pull request not close an issue?

When independent diagnosis shows the PR covers only part of the issue, targets the wrong owner, or fixes a symptom. The Skill recommends changing closing keywords like "Fixes #123" before merge so the remaining live issue is not closed accidentally.