superpowers-debug
A structured workflow for isolating and resolving software bugs.
Install
mkdir -p .claude/skills/superpowers-debug && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/7987" && unzip -o skill.zip -d .claude/skills/superpowers-debug && rm skill.zipInstalls to .claude/skills/superpowers-debug
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
Systematic debugging: reproduce, isolate, form hypotheses, instrument, fix, and add regression tests. Use when troubleshooting errors, failing tests, or unexpected behavior.Key capabilities
- →Capture exact error and environment details
- →Isolate issues to minimal reproduction cases
- →Rank hypotheses by likelihood
- →Add temporary instrumentation for diagnostics
- →Implement root cause fixes
- →Add regression tests for future prevention
How it works
The skill enforces a strict seven-step workflow starting from reproduction and minimization, moving through hypothesis testing and instrumentation, and concluding with a verified fix and regression test.
Inputs & outputs
When to use superpowers-debug
- →Troubleshoot runtime errors
- →Fix flaky test suites
- →Isolate regressions in legacy code
- →Add regression tests for new fixes
About this skill
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
When not to use it
- →When the issue is not reproducible
- →When the problem is not a runtime error, test failure, or regression
Limitations
- →Requires a reproducible case to be effective
- →Performance and timeout issues are limited to initial triage only
How it compares
Unlike ad-hoc debugging, this skill mandates a structured, repeatable process that prevents skipping critical verification and regression-protection steps.
Compared to similar skills
superpowers-debug side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| superpowers-debug (this skill) | 0 | 6mo | No flags | Intermediate |
| python-testing-patterns | 77 | 2mo | Review | Intermediate |
| chrome-devtools | 41 | 7mo | Review | Intermediate |
| bats | 9 | 7mo | Review | Intermediate |
Try saying
Example prompts that trigger this skill in your AI assistant.
More by anthonylee991
View all by anthonylee991 →You might also like
python-testing-patterns
wshobson
Implement comprehensive testing strategies with pytest, fixtures, mocking, and test-driven development. Use when writing Python tests, setting up test suites, or implementing testing best practices.
chrome-devtools
mrgoonie
Browser automation, debugging, and performance analysis using Puppeteer CLI scripts. Use for automating browsers, taking screenshots, analyzing performance, monitoring network traffic, web scraping, form automation, and JavaScript debugging.
bats
OleksandrKucherenko
Bash Automated Testing System (BATS) for TDD-style testing of shell scripts. Use when: (1) Writing unit or integration tests for Bash scripts, (2) Testing CLI tools or shell functions, (3) Setting up test infrastructure with setup/teardown hooks, (4) Mocking external commands (curl, git, docker), (5) Generating JUnit reports for CI/CD, (6) Debugging test failures or flaky tests, (7) Implementing test-driven development for shell scripts.
browser-daemon
noiv
Persistent browser automation via Playwright daemon. Keep a browser window open and send it commands (navigate, execute JS, inspect console). Perfect for interactive debugging, development, and testing web applications. Use when you need to interact with a browser repeatedly without opening/closing it.
performance-profiling
davila7
Performance profiling principles. Measurement, analysis, and optimization techniques.
obsidian-local-dev-loop
jeremylongshore
Configure Obsidian plugin development with hot-reload and fast iteration. Use when setting up development workflow, configuring test vaults, or establishing a rapid development cycle. Trigger with phrases like "obsidian dev loop", "obsidian hot reload", "obsidian development workflow", "develop obsidian plugin".