| name | bug-finder |
| description | Investigate, reproduce, and fix software bugs across frontend, backend, tests, and CI. Use when the user asks to debug errors, find root causes, triage regressions, explain failures, or verify bug fixes. |
Bug Finder Skill
Debug with evidence, not guesswork. Reproduce first, narrow scope fast, patch minimally, then verify.
Workflow
- Capture expected behavior, actual behavior, and environment details.
- Reproduce locally; if needed, add a minimal failing test or script.
- Isolate the failure path from entry point to breaking line.
- Form one or two hypotheses and test each with targeted logs/assertions.
- Implement the smallest safe fix that follows existing project patterns.
- Verify with focused tests first, then broader checks as needed.
- Add or update a regression test when possible.
- Report symptom, root cause, fix, and validation evidence.
Triage Priorities
- Prefer deterministic repro steps over manual one-off checks.
- Check recent commits, config changes, and dependency bumps early.
- For flaky failures, capture seed, timing, retries, and concurrency conditions.
- If a third-party service is involved, isolate with mocks/stubs before broad refactors.
Output Format
- Symptom
- Root cause
- Code fix
- Validation performed
- Remaining risk and follow-up
