# Bug Finder

> Debug bugs with reproduction, root cause, minimal fix, and verification.

- Skill: `kyrie66nb/bug-finder` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add kyrie66nb/bug-finder`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kyrie66nb/bug-finder/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: kyrie66nb (https://skillmd.com/u/kyrie66nb)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kyrie66nb/bug-finder

---


# Bug Finder Skill

Debug with evidence, not guesswork. Reproduce first, narrow scope fast, patch minimally, then verify.

## Workflow
1. Capture expected behavior, actual behavior, and environment details.
2. Reproduce locally; if needed, add a minimal failing test or script.
3. Isolate the failure path from entry point to breaking line.
4. Form one or two hypotheses and test each with targeted logs/assertions.
5. Implement the smallest safe fix that follows existing project patterns.
6. Verify with focused tests first, then broader checks as needed.
7. Add or update a regression test when possible.
8. 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