---
name: Debugging Wizard
slug: debugging-wizard
category: Quality
description: Debugging Wizard parses error messages and stack traces, correlates logs, and applies systematic hypothesis-driven debugging to isolate and resolve bugs. Use when investigating errors, analyzing stack traces, finding root causes, troubleshooting crashes, or performing log analysis.
github: "https://github.com/Jeffallan/claude-skills/tree/main/skills/debugging-wizard"
language: Python
stars: 11014
forks: 1033
install: "npx degit https://github.com/Jeffallan/claude-skills/tree/main/skills/debugging-wizard ~/.claude/skills/debugging-wizard"
installs_to: ~/.claude/skills/debugging-wizard
source_path: skills/debugging-wizard/SKILL.md
collection_size: 25
category_size: 1354
collection_url: "https://dirskills.com/collections/Jeffallan/claude-skills"
added: 2026-08-15T06:50:06.504Z
last_synced: 2026-08-15T06:50:06.504Z
canonical_url: "https://dirskills.com/skills/debugging-wizard"
---

# Debugging Wizard

Debugging Wizard parses error messages and stack traces, correlates logs, and applies systematic hypothesis-driven debugging to isolate and resolve bugs. Use when investigating errors, analyzing stack traces, finding root causes, troubleshooting crashes, or performing log analysis.

**Install:**

```bash
npx degit https://github.com/Jeffallan/claude-skills/tree/main/skills/debugging-wizard ~/.claude/skills/debugging-wizard
```

## README

# Debugging Wizard

Expert debugger applying systematic methodology to isolate and resolve issues in any codebase.

## Core Workflow

1. **Reproduce** - Establish consistent reproduction steps
2. **Isolate** - Narrow down to smallest failing case
3. **Hypothesize and test** - Form testable theories, verify/disprove each one
4. **Fix** - Implement and verify solution
5. **Prevent** - Add tests/safeguards against regression

## Reference Guide

Load detailed guidance based on context:

<!-- Systematic Debugging row adapted from obra/superpowers by Jesse Vincent (@obra), MIT License -->

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Debugging Tools | `references/debugging-tools.md` | Setting up debuggers by language |
| Common Patterns | `references/common-patterns.md` | Recognizing bug patterns |
| Strategies | `references/strategies.md` | Binary search, git bisect, time travel |
| Quick Fixes | `references/quick-fixes.md` | Common error solutions |
| Systematic Debugging | `references/systematic-debugging.md` | Complex bugs, multiple failed fixes, root cause analysis |

## Constraints

### MUST DO
- Reproduce the issue first
- Gather complete error messages and stack traces
- Test one hypothesis at a time
- Document findings for future reference
- Add regression tests after fixing
- Remove all debug code before committing

### MUST NOT DO
- Guess without testing
- Make multiple changes at once
- Skip reproduction steps
- Assume you know the cause
- Debug in production without safeguards
- Leave console.log/debugger statements in code

## Common Debugging Commands

**Python (pdb)**
```bash
python -m pdb script.py          # launch debugger
# inside pdb:
# b 42          — set breakpoint at line 42
# n             — step over
# s             — step into
# p some_var    — print variable
# bt            — print full traceback
```

**JavaScript (Node.js)**
```bash
node --inspect-brk script.js     # pause at first line, attach Chrome DevTools
# In Chrome: open chrome://inspect → click "inspect"
# Sources panel: add breakpoints, watch expressions, step through
```

**Git bisect (regression hunting)**
```bash
git bisect start
git bisect bad                   # current commit is broken
git bisect good v1.2.0           # last known good tag/commit
# Git checks out midpoint — test, then:
git bisect good   # or: git bisect bad
# Repeat until git identifies the first bad commit
git bisect reset
```

**Go (delve)**
```bash
dlv debug ./cmd/server           # build & attach
# (dlv) break main.go:55
# (dlv) continue
# (dlv) print myVar
```

## Output Templates

When debugging, provide:
1. **Root Cause**: What specifically caused the issue
2. **Evidence**: Stack trace, logs, or test that proves it
3. **Fix**: Code change that resolves it
4. **Prevention**: Test or safeguard to prevent recurrence

[Documentation](https://jeffallan.github.io/claude-skills/skills/quality/debugging-wizard/)