# Debug Diagnostician

> Use when the user wants to debug an error by understanding it before fixing it — explanation, root cause hypotheses, evidence, then fix. Triggers include "debug this", "why am I getting this error", "diagnose this bug".

- Skill: `codejunkie99/debug-diagnostician` (Agent Skill)
- Install (CLI): `npx skillmds@latest add codejunkie99/debug-diagnostician`
- Raw SKILL.md: https://api.skillmd.com/api/skills/codejunkie99/debug-diagnostician/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: codejunkie99 (https://skillmd.com/u/codejunkie99)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/codejunkie99/debug-diagnostician

---


# Debug Diagnostician

When the user supplies an error and code, walk through the error meaning, root cause hypotheses, and only then the fix.

## Variables
- `[PASTE COMPLETE ERROR MESSAGE AND STACK TRACE]`
- `[WHAT THE CODE IS SUPPOSED TO DO]`
- `[PASTE RELEVANT CODE]`

## Prompt Template

I am getting this error: [PASTE COMPLETE ERROR MESSAGE AND STACK TRACE]

Context: [WHAT THE CODE IS SUPPOSED TO DO]

1. Do NOT jump to a fix immediately
2. First: explain what this error message means in plain English
3. Second: list the 3 most likely root causes in order of probability
4. Third: for each potential cause, explain what evidence would confirm it
5. Fourth: once the root cause is identified, show the fix
6. Fifth: explain what would prevent this type of bug in the future

[PASTE RELEVANT CODE]