Hands-OnAI
← All skills
AutomationNewFreeWorks in Claude Code · Claude app · Codex

Systematic Debugging

Find the real root cause of a bug instead of guessing at fixes.

Part of Superpowers by @obra ↗

Systematic Debugging changes how Claude handles anything broken — a bug, a failing test, strange behavior. Instead of guessing and patching, it investigates methodically: reproduce the problem, form a hypothesis, test it, and only then fix the actual root cause. Fewer band-aids, more real solutions.

What it does

  • Kicks in on any bug, failing test, or unexpected behavior — before proposing a fix.
  • Reproduces the problem and forms a clear hypothesis first.
  • Tests the hypothesis instead of guessing, then fixes the true root cause.
  • Cuts down on the “try random things until it works” spiral.

When it kicks in

Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes

Topics the skill covers

  • The Iron Law
  • The Four Phases
  • Red Flags - STOP and Follow Process
  • your human partner's Signals You're Doing It Wrong
  • Common Rationalizations
  • Quick Reference
  • When Process Reveals "No Root Cause"
  • Supporting Techniques
  • Real-World Impact

What's inside the download

  • SKILL.md — the systematic debugging workflow, ready to install.

11 files in the .zip:

  • Skill InstructionsSKILL.md9.7 KB
  • Condition Based Waiting Examplecondition-based-waiting-example.ts4.9 KB
  • Condition Based Waitingcondition-based-waiting.md3.4 KB
  • Creation LogCREATION-LOG.md4.2 KB
  • Defense in Depthdefense-in-depth.md3.6 KB
  • Find Polluterfind-polluter.sh1.5 KB
  • Root Cause Tracingroot-cause-tracing.md5.2 KB
  • Test Academictest-academic.md653 B
  • Test Pressure 1test-pressure-1.md1.9 KB
  • Test Pressure 2test-pressure-2.md2.2 KB
  • Test Pressure 3test-pressure-3.md2.6 KB

How to install (2 minutes)

Same download for Claude Code, Claude app, Codex — follow the step for the tool you use.

  1. 1Download the .zip and unzip it — you’ll get a folder called systematic-debugging.
  2. 2In the Claude app: open Settings → Capabilities → Skills, choose Add / Upload, and select the folder (or the .zip).
  3. 3In Claude Code: drop the folder into your project’s .claude/skills/ directory, then type /skills to confirm it loaded.
  4. 4In Codex: drop the folder into ~/.agents/skills/ (or your project’s .agents/skills/), then type /skills — or call it directly with $systematic-debugging.
  5. 5That’s it — the skill activates on its own when it fits what you’re doing.

New to skills? Our Claude Cowork beginner's guide shows how they work inside Claude.

Want to get the most out of your new skill?

Inside Hands-On AI Club we show you exactly how to use skills like this in real work — with step-by-step courses that show every move.