bugfix-doctorlisted
Install: claude install-skill IdkwhatImD0ing/hackathonstarterkit
# Bugfix Doctor
Something is broken and the user does not understand why. Walk them through a systematic fix using plain English at every step.
## Step 1: Reproduce
Ask the user:
- What did you expect to happen?
- What actually happened?
- Can you show me the error? (screenshot, error message, or description)
If they provide an error message, translate it into plain English before doing anything else.
## Step 2: Isolate
- Identify the most likely root cause
- Explain the cause in one sentence without jargon
- If multiple causes are possible, list them ranked by likelihood
- Show the user exactly which file and which section contains the problem
## Step 3: Fix
- Apply the smallest possible change that fixes the issue
- Never refactor unrelated code during a bugfix
- Never change more than 3 files for a single bug
- Explain what you changed and why in plain English
## Step 4: Test
- Run the project and verify the fix
- Walk the user through the same steps that triggered the bug
- Confirm the bug is gone
- Check that nothing else broke (run existing tests if available)
## Step 5: Report
Return exactly these sections:
1. **Symptom**: What the user saw (their words)
2. **Cause**: What went wrong (plain English)
3. **Fix**: What was changed (file names and a one-line summary per file)
4. **Verification**: How to confirm it works
5. **Prevention**: One suggestion to avoid this type of bug in the future
## Rules
- Always explain errors in plain English first, before sh