Bug Hunt Loop
A disciplined loop for hard bugs and slowdowns.
What it does
Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.
Install in under a minute
Mac or Linux, after you download
unzip bug-hunt-loop.zip -d ~/.claude/skills/Windows PowerShell
Expand-Archive bug-hunt-loop.zip -DestinationPath $HOME\.claude\skills- Start a new Claude Code session so it sees the skill.
- Ask in plain words, for example: "Use Bug Hunt Loop on this project."
- Unzip the download, then zip just the bug-hunt-loop folder if your computer added an extra folder.
- In Claude.ai, open Settings, then Capabilities, and upload it under Skills.
- Turn the skill on and ask Claude to use it.
Bug Hunt Loop uses the open SKILL.md format, so it also works in agents like Cursor, Gemini CLI, GitHub Copilot and Codex. Copy the bug-hunt-loop folder into that agent's skills folder, for example .cursor/skills/ or .github/skills/ in your project.
What's inside
The 7 main sections of the SKILL.md, in order.
- Redact
- Phase 1: Build a feedback loop
- Phase 2: Reproduce + minimise
- Phase 3: Hypothesise
- Phase 4: Instrument
- Phase 5: Fix + regression test
- Phase 6: Cleanup
In the download: agents/openai.yaml, LICENSE, NOTICE.md, scripts/hitl-loop.template.sh, SKILL.md
Credit and license
Bug Hunt Loop is a renamed, packaged copy of diagnosing-bugs by Matt Pocock (github.com/mattpocock/skills), used under the MIT license. The license and a list of changes ship inside the download.
Questions
Does Bug Hunt Loop work in Claude.ai, not just Claude Code?
Yes. In Claude.ai, upload the bug-hunt-loop folder as a zip in Settings under Capabilities. It also works in other agents that support Agent Skills, like Cursor, Gemini CLI and GitHub Copilot.
What do I get?
A zip with the bug-hunt-loop folder: its SKILL.md (2,094 words) and its license files. One payment, instant download.
Who made Bug Hunt Loop?
It's a renamed, packaged copy of diagnosing-bugs by Matt Pocock, used under the MIT license. The license and a list of changes ship inside the download.