bug-report

Convert vague bug descriptions into minimized, executed reproduction steps and an investigation prompt.

3|Updated Sep 5, 2021
One-click install
npx skills add https://github.com/aviralmansingka/dotfiles --skill bug-report-aviralmansingka
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-report
Source: https://github.com/aviralmansingka/dotfiles/tree/main/claude/.claude/skills/bug-report
Command: npx skills add https://github.com/aviralmansingka/dotfiles --skill bug-report-aviralmansingka

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It transforms an unclear bug report into a minimized, executed, and re-verified reproduction along with a structured investigation prompt that enables reliable root-cause debugging.

Core Features & Use Cases

  • Rigid triage-to-handoff workflow: Guides investigation through triage, repro capture, execution, minimization, re-verification, hypothesis generation, and final handoff.
  • Evidence-first debugging: Records an evidence buffer after each executed step, so hypotheses are grounded in observed outputs rather than assumptions.
  • Investigation-ready prompt: Produces a single, structured prompt that a fresh investigator (human or LLM) can use to confirm or refute ranked hypotheses.

Quick Start

Ask the assistant to run the skill by sending: /bug-report and include a one-line summary of what is failing.

Frequently Asked Questions about bug-report

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

FAQPage Schema
How do I turn a vague bug description into a minimized reproduction case?

To turn a vague bug description into a minimized reproduction, use an eight-phase debugging workflow that triages the issue, captures the repro, executes commands, reduces the case, and re-verifies the defect. This structured process grounds the final handoff in observed evidence rather than assumptions.

What is the best way to structure root cause analysis for uncertain environments?

The best way to structure root cause analysis across uncertain environments is to generate ranked hypotheses backed by an evidence buffer of executed commands. This approach produces a structured investigation prompt that a fresh human or LLM investigator can use to systematically confirm or refute the root cause.

How do I create a bug report with executable reproduction steps?

You create a bug report with executable reproduction steps by applying a rigid triage-to-handoff workflow that explicitly defines phase exit criteria. The process captures, executes, and minimizes reproduction steps while recording an evidence buffer after each action to ensure the defect is reliably validated.

Can I use an evidence-first debugging approach for triage and hypothesis generation?

Yes, you can use an evidence-first debugging approach for triage and hypothesis generation. This method records an evidence buffer after every executed step, ensuring that generated hypotheses are grounded in observed outputs and producing an investigation-ready prompt for systematic root-cause debugging.

How do I reduce a vague software bug into tight, executable repros?

You reduce a vague software bug into tight, executable repros by applying an eight-phase machine that captures the initial reproduction, executes it, and minimizes the steps. The workflow enforces explicit phase exit criteria and re-verifies the minimized reproduction before final handoff.

What are the limitations of using a rigid triage workflow for bug reproduction?

The limitations of using a rigid triage workflow for bug reproduction include the necessity of meeting explicit phase exit criteria before advancing. This disciplined debugging workflow requires strict evidence buffering and execution at each step, which may not suit rapid, ad-hoc defect investigation scenarios lacking clear entry points.