Category: Development
Systematic Debugging
A Superpowers skill that blocks symptom patching and requires root cause investigation before any fix.
Works with
What it does
- Four phases: root cause investigation, pattern analysis, hypothesis testing, fix with tests
- No fixes until evidence gathering and data-flow tracing are done
- Instruments multi-component systems and traces call stacks backward
- Questions the architecture after three failed fixes
When to use it
Use it when bugs an agent "fixed" keep coming back, or speculative patches pile up.
How to install
- Run the command below in your terminal. Pick the agents you use (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more) and it installs into the right folder.
npx skills add https://github.com/obra/superpowers --skill systematic-debugging
- To install manually, download the
systematic-debuggingskill folder from the GitHub repository and copy it into your agent's skills folder, such as~/.claude/skills/or.cursor/skills/. - Ask your agent for a related task and the skill is used automatically.