Skip to content
Engineering
Public upstreamMatt PocockPublic source

Matt Pocock bug diagnosis

Build a precise failure signal, minimize the reproduction and test competing causes.

Read SKILL.md

Workflow

Matt Pocock’s diagnosis loop begins with a fast red-capable reproduction, then minimizes it, ranks hypotheses, instruments specific predictions and verifies the final fix.

Use when

  • Investigate a difficult bug or performance regression.

Required inputs

  • Exact reported symptom
  • Code, environment and permitted diagnostic tools

Expected outputs

  • Minimal reproduction and root cause
  • Fix, regression evidence and diagnostic cleanup

Prerequisites

  • Access to an environment or fixture that can reproduce the reported symptom.
  • Redact secrets in commands, logs and captured artifacts; retain companion diagnostic scripts.

Installation

Run this command in your project after reviewing the instructions and access terms. Install complete upstream directories to keep referenced rules and scripts.

npx skills add https://github.com/mattpocock/skills/tree/5beb35b040e3de97e54fa9e386d7e42d15c295c2/skills/engineering/diagnosing-bugs --skill diagnosing-bugs --agent claude-code

Project file: .claude/skills/diagnosing-bugs/SKILL.md

Read the setup guide

Selection brief

This brief helps you choose the skill. Read the complete upstream SKILL.md and companion files for its actual instructions.

# Matt Pocock bug diagnosis (matt-pocock-bug-diagnosis)
Matt Pocock’s diagnosis loop begins with a fast red-capable reproduction, then minimizes it, ranks hypotheses, instruments specific predictions and verifies the final fix.

## Use when
- Investigate a difficult bug or performance regression.

## Required inputs
- Exact reported symptom
- Code, environment and permitted diagnostic tools

## Prerequisites
- Access to an environment or fixture that can reproduce the reported symptom.
- Redact secrets in commands, logs and captured artifacts; retain companion diagnostic scripts.

## Expected outputs
- Minimal reproduction and root cause
- Fix, regression evidence and diagnostic cleanup

Source: https://github.com/mattpocock/skills/blob/5beb35b040e3de97e54fa9e386d7e42d15c295c2/skills/engineering/diagnosing-bugs/SKILL.md
Full SKILL.md: https://agenttaste.dev/skills/matt-pocock-bug-diagnosis/SKILL.md

## Popularity evidence
- 297,596 GitHub repo stars — mattpocock/skills; checked 2026-10-20. Source: https://github.com/mattpocock/skills/stargazers
- 810,548 skill installs (all time) — mattpocock/skills / diagnosing-bugs · skills.sh · all time; checked 2026-10-20. Source: https://skills.sh/mattpocock/skills/diagnosing-bugs
Adoption counts are not user ratings or guarantees of quality.

Related skills

Browse all skills →
AgentTastePro

Claude Code Clean Architecture

Enforce strict separation between database, business logic, and UI in autonomous sessions.

Claude Code · Codex · Antigravity

SKILL.md
VercelPublic source

React best practices

Review React and Next.js code for rendering, data fetching and bundle performance.

Claude Code · Cursor · Codex · Antigravity

SKILL.mdSource ↗