diagnosing-bugs
A skill from Matt Pocock's skills collection that gives the agent a fixed order for hard bugs and performance regressions.
What the skill teaches
A skill from Matt Pocock's skills collection that gives the agent a fixed order for hard bugs and performance regressions. Before reading code for a theory, the agent must build one fast, repeatable command that fails on this bug, choosing from options such as a failing test, an HTTP script, a browser script, a bisection harness or a human-in-the-loop script. It then shrinks the reproduction, lists three to five testable hypotheses for the user, probes one variable at a time with tagged debug logs, writes a regression test before the fix where a suitable seam exists, and removes all instrumentation at the end. Secrets in any output must be redacted.
Capabilities
- Build a repeatable pass/fail loop for a bug
- Shrink a reproduction to its essential parts
- Rank testable hypotheses before changing code
- Add a regression test before the fix
- Remove tagged debug instrumentation afterwards
About
- Publisher
- Matt Pocock
- Tool
- Debugging
Install
The project doesn't document install steps that we could confirm. See the project's own instructions
What's inside
- agents/openai.yaml
- scripts/hitl-loop.template.sh
MCP servers and skills can run code on your computer and act on your data. Review the source before installing.
This skill includes scripts that your agent may run.
Details
| Fact | Value | Source |
|---|---|---|
| Type | Skill | |
| Tool | Debugging | |
| Publisher | Matt Pocock | source |
| Official status | Not stated in its documentation | |
| Needs an API key or sign-in | Not stated in its documentation | |
| Includes scripts | Yes | source |
| Platforms | Not stated in its documentation | |
| AI clients | Not stated in its documentation | |
| Licence | MIT | source |
| Pricing | Not stated in its documentation | |
| Activity | Last commit Nov 9, 2026321,493 GitHub starsDownload data not available (not on npm or PyPI) | source |
| Links | Repository Website |
Copies of this skill in other repositories (10)
These differ from this skill's text. They may be adapted copies or older versions.
- diagnosing-bugsfradser/dotclaude
- diagnosing-bugssvyatov/supermatt
- diagnosing-bugsethanyoq/skill-hub
- diagnosing-bugskings0527/pi-harness
- diagnosing-bugsleek/agent-skills
- diagnosing-bugsvalorvie/custom-skills
- diagnosing-bugshjdspace/spacecode
- diagnosing-bugstoverux/cantrips
- diagnosing-bugsandymelnykov/teamostemplate
- diagnosing-bugsdaidaij/my-skills
More from Matt Pocock
22 skills
- writing-beats (Skill)
- writing-fragments (Skill)
- setup-matt-pocock-skills (Skill)
- triage (Skill)
- codebase-design (Skill)
- domain-modeling (Skill)
Also listed under: Debugging
Sources
- Skill file (SKILL.md)github.com/mattpocock/skills · Backs: Includes scriptsNov 10, 2026
- GitHub repositorygithub.com/mattpocock/skills · Backs: Licence, Publisher, ActivityNov 11, 2026
- Folder in the repository (diagnosing-bugs)github.com/mattpocock/skills · Backs: Includes scriptsNov 10, 2026