mattpocock logo
#26 by installsCoding & architecturemattpocock/skills

diagnosing-bugs

Systematic diagnosis loop for hard bugs and performance regressions with tight feedback loops

Installs
844K
all time
This week
37.5K
installs
Repo stars
276.1K
GitHub
First seen
Jun 4, 2026
on skills.sh
Install
npx skills add https://github.com/mattpocock/skills --skill diagnosing-bugs
Works with Claude Code, Cursor, Codex, GitHub Copilot, Windsurf, Gemini CLI and other agents that read SKILL.md.
What it does

A disciplined approach to debugging complex issues by prioritizing tight pass/fail feedback loops over code inspection. Use when facing hard-to-reproduce bugs, performance regressions, or cryptic failures. Emphasizes building instrumentation and test harnesses before hypothesis testing, with careful redaction of secrets in all artifacts.

  • Constructs tight feedback loops (pass/fail signals) before diving into code exploration
  • Guides systematic bisection and hypothesis testing against reproducible test cases
  • Reads GLOSSARY.md and ADRs to build accurate mental models of affected modules
  • Securely redacts credentials and secrets while capturing diagnostic artifacts for analysis