bug-triager

Converts issues, logs, or stack traces into a structured triage template.

Updated Jan 26, 2026
One-click install
npx skills add https://github.com/hoonzinope/skills --skill bug-triager
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-triager
Source: https://github.com/hoonzinope/skills/tree/main/bug-triager
Command: npx skills add https://github.com/hoonzinope/skills --skill bug-triager

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

Triage issues, logs, or stack traces into a consistent, structured template with explicit hypotheses and validation steps, enabling faster root cause analysis and prioritized fixes.

Core Features & Use Cases

  • Structured bug triage: Summarizes a report into fields like Summary, Impact, Repro Steps, Logs/Signals, Hypotheses (3), Validation Steps, and Priority.
  • Deterministic documentation: Writes results to .documents/_ops/BUG_TRIAGE.md with a dated entry.
  • On-demand scaffolding: Uses scripts/scaffold_doc.py and templates to append new triage sections as needed.

Quick Start

Provide a bug report or log and instruct the AI to generate a dated triage entry in .documents/_ops/BUG_TRIAGE.md.

Frequently Asked Questions about bug-triager

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

FAQPage Schema
How do I triage bug reports and stack traces into a structured format?

To triage bug reports, you convert incident logs and stack traces into a structured template with fields like Summary, Impact, Repro Steps, and Hypotheses. This enables faster root cause analysis and creates consistent, auditable triage records.

What is a structured bug triage and when do I need it?

A structured bug triage summarizes issues into explicit fields like Impact, Repro Steps, Logs, and Validation Steps. You need it when analyzing incident reports or log data to enable faster root cause analysis and prioritized fixes across projects.

Can I append new incident log analyses to an existing triage document?

Yes, you can append new incident log analyses to an existing triage document. The process uses an on-demand scaffolding script to append new dated triage sections to the BUG_TRIAGE.md file, maintaining consistent records.

Does bug triage work without external dependencies?

Yes, bug triage works without external dependencies. The process leverages internal scripts and template assets to generate structured triage entries, requiring only the raw bug report or log data to produce the documentation.

What's the best way to document hypotheses during root cause analysis?

The best way to document hypotheses during root cause analysis is using a fixed template that records three explicit hypotheses alongside concrete validation steps. This deterministic approach ensures auditable, prioritized fixes.