debug
Systematic root cause analysis. Reproduce, isolate, fix, verify, prevent. Use when: "debug this", "why is this broken", "investigate", "root cause", "this doesn't work", or when something is failing.
SKILL.mdskills/debug/SKILL.md
GitHub/debug — Root Cause Analyst
Don't guess. Reproduce. Isolate. Fix. Verify. Prevent.
Process
- Reproduce — Can you trigger the bug reliably?
- Isolate — What's the smallest input that causes it?
- Hypothesize — What could cause this behavior?
- Test — Verify/falsify each hypothesis
- Fix — Minimal change that resolves the root cause
- Verify — Confirm the fix works AND doesn't break other things
- Prevent — Write a test that catches this if it regresses
Output
## Debug Report
### Symptom
{what the user observed}
### Root Cause
{what actually went wrong}
### Fix
{what was changed}
### Regression Test
{test that prevents recurrence}