bug-hunter

Guide root-cause investigation for bugs, regressions, and test failures.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/oElberte/dotfiles --skill bug-hunter-oelberte
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bug-hunter
Source: https://github.com/oElberte/dotfiles/tree/main/private_dot_factory/skills/bug-hunter
Command: npx skills add https://github.com/oElberte/dotfiles --skill bug-hunter-oelberte

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you investigate confusing bugs quickly and accurately so you can identify root causes instead of applying ineffective symptom patches.

Core Features & Use Cases

  • Evidence-first debugging: Start with the complete error signal (stack trace, logs, warnings) and capture what you actually observed.
  • Reproduction-aware analysis: Decide whether you can reproduce the issue and, if not, determine what constraints prevent it.
  • Smallest clean fix planning: Form one root-cause hypothesis with evidence, rule out alternatives, then outline minimal changes plus a validation plan.

Quick Start

Ask the AI to “bug-hunt this failure” by providing the full error, recent diffs/commits, and relevant logs, then request a single root-cause hypothesis with a smallest safe fix and validation steps.

Frequently Asked Questions about bug-hunter

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

FAQPage Schema
How do I find the root cause of a flaky test instead of just patching the symptom?▼

Root cause analysis for flaky tests requires structured debugging across reproduction, recent changes, and execution-path tracing. You collect observed versus expected behavior and evidence to form a single hypothesis, rule out alternatives, and propose the smallest clean fix with a validation plan.

What is the best way to debug asynchronous state failures when I only have a stack trace?▼

Debugging asynchronous state failures starts with capturing the complete error signal and deciding if the issue is reproducible. By tracing execution paths and backward data state, you can map the exact failure point and outline a minimal safe fix with validation steps.

How do I investigate build failures and regressions from recent commits?▼

Investigating build failures and regressions involves analyzing recent diffs alongside the full error logs. You compare observed behavior against expected outcomes to isolate the triggering change, rule out alternative causes, and plan the smallest safe correction.

Can I use this approach for bugs that I cannot reliably reproduce?▼

Yes, this approach explicitly handles non-reproducible bugs by determining what specific constraints prevent reproduction. It then uses execution-path tracing and backward data or state tracing to build a root-cause hypothesis from the available evidence.

Does this debugging method work without any external dependencies or testing frameworks?▼

Yes, this debugging method works without external dependencies. It operates as a standalone reasoning process that guides you through reproduction, evidence collection, and hypothesis validation using your existing logs, stack traces, and code diffs.

When should I avoid proposing a fix during root cause analysis?▼

You should avoid proposing fixes until you have collected complete evidence, traced the execution path, and ruled out alternative hypotheses. Proposing a fix prematurely risks applying an ineffective symptom patch instead of resolving the actual root cause.