Category: Development
Diagnosing Bugs
A diagnosis loop for hard bugs and performance regressions.
Works with
What it does
- A discipline for hard bugs. Skip phases only when explicitly justified.
- When exploring the codebase, read
GLOSSARY.md(if it exists) to get a clear mental model of the relevant modules, and check ADRs in the area you're touching. - If the redacted output is not enough to diagnose the bug, say so and ask the user.
- Phase 1: Build a feedback loop
When to use it
A diagnosis loop for hard bugs and performance regressions.
How to install
- Run the command below in your terminal. Pick the agents you use (Claude Code, Codex, Cursor, Gemini CLI, Copilot, and more) and it installs into the right folder.
npx skills add https://github.com/mattpocock/skills --skill diagnosing-bugs
- To install manually, download the
diagnosing-bugsskill folder from the GitHub repository and copy it into your agent's skills folder, such as~/.claude/skills/or.cursor/skills/. - Ask your agent for a related task and the skill is used automatically.