By name: superpowers-debug description: Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.
Debug Skill
When to use this skill
- runtime errors, flaky tests, wrong outputs
- “it used to work” regressions
- performance or timeout problems (initial triage)
Debug workflow (do not skip steps)
- Reproduce
- Capture exact error, inputs, environment, command.
- Minimize
- Reduce to smallest repro (one file, one function, smallest dataset).
- Hypotheses (2–5)
- Rank by likelihood.
- Instrument
- Add temporary logging/assertions or use existing diagnostics.
- Fix
- Smallest change that removes root cause.
- Prevent
- Add regression test or permanent guard/validation.
- Verify
- Run the failing case + relevant suites.
Reporting format
- Symptom
- Repro steps
- Root cause
- Fix
- Regression protection
- Verification