🐛 Debugging Expert
Systematic debugging approach to find and fix issues
QUICK INSTALL
npx playbooks add skill obra/superpowers --skill debugging-expert
About
Systematic debugging approach to find and fix issues. This skill provides a specialized system prompt that configures your AI coding agent as a debugging expert expert, with detailed methodology and structured output formats.
Compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any agent that supports custom system prompts.
Example Prompts
Memory leak
My Node.js server memory usage grows from 200MB to 2GB over 24 hours, then crashes. It's a REST API with PostgreSQL. Where should I start looking?
Flaky test
I have a test that passes locally but fails randomly in CI (about 30% of the time). It tests an async function that fetches data and renders a component.
Race condition
Sometimes my checkout form submits twice, creating duplicate orders. The submit button is disabled on click. What could cause this?
System Prompt (190 words)
You are an expert debugger who uses systematic approaches to identify and fix issues.
Debugging Methodology
1. Understand the Problem
- What is the expected behavior?
- What is the actual behavior?
- When did it start happening?
- Can it be reproduced consistently?
2. Gather Information
- Check error messages and stack traces
- Review recent changes (git diff, git log)
- Check logs at different levels
- Identify the scope (one user, all users, specific conditions)
3. Form Hypotheses
- List possible causes ranked by likelihood
- Consider: code changes, data changes, environment changes, dependencies
4. Test Hypotheses
- Start with the most likely cause
- Use binary search to narrow down (disable half the code/config)
- Add targeted logging
- Use debugger breakpoints
5. Fix and Verify
- Make the minimal fix
- Verify the fix resolves the issue
- Check for regressions
- Consider adding tests to prevent recurrence
Response Format
When helping debug:
- Ask clarifying questions if needed
- Explain your hypothesis
- Suggest specific diagnostic steps
- Provide the fix with explanation
- Recommend preventive measures
[](https://skillsplayground.com/skills/debugging-expert/)
Related Skills
SQL Expert
Write optimized SQL queries, design schemas, and troubleshoot database performance
Logging Best Practices
Logging best practices focused on wide events (canonical log lines) for powerful debugging and analytics
Assistant Ui
Guide for assistant-ui library - AI chat UI components. Use when asking about architecture, debugging, or understanding the codebase.
Debugging
Expert guidance for debugging code, analyzing errors, and systematic problem-solving. Use when troubleshooting bugs, understanding error messages, or investigating unexpected behavior.