bug-hunter

Diagnose software bugs through investigation, reproduction, and root-cause analysis.

69|5|Updated Nov 16, 2025
One-click install
npx skills add https://github.com/nahisaho/musubi --skill bug-hunter-nahisaho
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bug-hunter
Source: https://github.com/nahisaho/musubi/tree/main/.claude/skills/bug-hunter
Command: npx skills add https://github.com/nahisaho/musubi --skill bug-hunter-nahisaho

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? This Skill eliminates the time-consuming and complex process of manual bug investigation, root cause analysis, and fix generation. It streamlines debugging, allowing developers to focus on new features and reduce system downtime.

Core Features & Use Cases:

  • Structured Bug Investigation: Guides through collecting symptoms, reproduction steps, and environment details.
  • Root Cause Analysis (RCA): Applies techniques like 5 Whys and Fishbone diagrams to identify underlying issues.
  • Fix Generation & Proposal: Suggests short-term, medium-term, and long-term solutions with code examples.
  • Use Case: A user reports a critical production error. This Skill can walk through the debugging process, analyze logs, pinpoint the database connection pool exhaustion as the root cause, and propose code changes to fix it, including scaling the pool and adding frontend error handling.

Quick Start: I have a bug in my web application. The dashboard is showing a blank screen after login. Help me debug it.

Frequently Asked Questions about bug-hunter

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

FAQPage Schema
How do I debug a bug when I don't know where to start?

Structured bug investigation begins by collecting symptoms, reproduction steps, and environment details. This Skill guides you through gathering evidence systematically—analyzing logs, stack traces, and minimal reproducible examples—then applies root cause analysis techniques like 5 Whys to identify the underlying issue rather than just the surface symptom.

What's the best way to find the root cause of a production error?

Root cause analysis applies structured techniques like Fishbone diagrams and the 5 Whys method to trace failures back to their origin. This Skill walks through log and stack-trace analysis, hypothesis testing, and failure-mode identification to pinpoint the actual cause so fixes address the problem, not just symptoms.

How do I generate a fix once I've identified a bug?

After diagnosis, this Skill proposes short-term, medium-term, and long-term solutions with code examples and implementation steps. It produces actionable fix proposals backed by evidence gathering and verification steps, reducing the gap between identifying a problem and deploying a corrective action.

Can I use this for debugging across multiple sessions and environments?

Yes. This Skill applies across debugging sessions by collecting environment details, reproduction steps, and system context. It handles log and stack-trace analysis, minimal reproducible examples, and structured RCA workflows—satisfying requirements for reproducibility, evidence gathering, and consistent debugging across different conditions.

What information do I need to collect before starting root cause analysis?

Effective bug investigation requires symptoms, reproduction steps, environment details, logs, and stack traces. This Skill guides structured collection of this input data, helping you create minimal reproducible examples and gather evidence needed to apply hypothesis testing and debugging tools accurately.

How does this reduce the time spent on manual bug investigation?

This Skill streamlines debugging by automating the investigation workflow—guiding evidence collection, applying proven RCA techniques, and generating fix proposals with implementation steps. It eliminates manual trial-and-error, allowing developers to move faster from problem report to corrective action and system restoration.