# diagnosing-bugs

Agent skill by Matt Pocock (https://www.totaltypescript.com)

Stops the agent from guessing at a fix. It reproduces, narrows, forms one hypothesis at a time and tests it, which is the difference between a bug being fixed and a symptom being buried.

Topics: Debugging
Last updated: 2026-08-19 (28 days ago)
Source: https://github.com/mattpocock/skills
Repository: https://github.com/mattpocock/skills

## Install

```bash
npx skills add https://github.com/mattpocock/skills --skill diagnosing-bugs
```

## In the author's words

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.

## Verification

- Source link: Resolved (HTTP 200) (pass)
- Repository: Resolves on GitHub (pass)
- Install command: Transcribed from the author's own page (pass)
- Maintenance: Last updated 28 days ago (pass)
- Attribution: Credited to Matt Pocock (pass)

Full page: https://stackskills.dev/library/diagnosing-bugs