debugger-investigation

Guide debugging investigations with structured techniques and repeatable diagnostics.

1|Updated Feb 22, 2026
One-click install
npx skills add https://github.com/gonz0w/bgsd-oc --skill debugger-investigation
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debugger-investigation
Source: https://github.com/gonz0w/bgsd-oc/tree/main/skills/debugger-investigation
Command: npx skills add https://github.com/gonz0w/bgsd-oc --skill debugger-investigation

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The debugger's toolbox provides a structured approach to identify, isolate, and fix bugs efficiently across codebases and environments.

Core Features & Use Cases

  • Binary Search / Divide and Conquer to narrow down causing factors.
  • Rubber Duck Debugging to verbalize and discover gaps in mental models.
  • Minimal Reproduction to isolate the smallest failing scenario.
  • Working Backwards to trace from the desired outcome to root cause.
  • Differential Debugging to compare environments or commits.
  • Observability First to add visibility before making changes.
  • Comment Out Everything to disable interactions and pinpoint root causes.
  • Git Bisect to traverse commits and locate the first bad one.
  • Technique Selection Guide to choose the right method for a situation.
  • Combining Techniques to orchestrate a robust investigation workflow.

Quick Start

Describe the problem to be solved, select a primary investigation technique based on symptoms, then iteratively apply steps to isolate the root cause.

Frequently Asked Questions about debugger-investigation

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

FAQPage Schema
How do I isolate the root cause of an intermittent failure in a complex codebase?

To isolate intermittent failures in complex codebases, apply structured debugging techniques like binary search to narrow factors and minimal reproduction to find the smallest failing scenario, reducing mean time to repair quickly.

What's the best way to find the specific commit that introduced a bug?

Finding the specific commit that introduced a bug is best achieved using git bisect, which traverses commit history to locate the first bad commit by systematically narrowing the search range.

How does rubber duck debugging help fix code issues?

Rubber duck debugging helps fix code issues by forcing you to verbalize your logic step-by-step, which exposes gaps in your mental model and often reveals the root cause without requiring tool assistance.

When should I use differential debugging instead of working backwards?

Use differential debugging to compare environments or commits when a system works in one place but fails in another, whereas working backwards traces from the desired outcome to root cause.

Can I combine multiple debugging techniques to investigate a difficult issue?

You can combine multiple debugging techniques to orchestrate a robust investigation workflow, selecting a primary method based on symptoms and iteratively applying steps to isolate the root cause effectively.

Why should I add observability before making changes to fix a bug?

Adding observability before making changes provides visibility into system behavior, ensuring you accurately pinpoint root causes rather than guessing, which is a core principle of the observability first debugging approach.