# Better Debugger

> Root-cause debugging skill that correlates symptoms, logs, stack traces, and code paths into an evidence-backed diagnosis.

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

---


# Better Debugger (Codex)

Use this skill for systematic root-cause analysis.

## Trigger

Use when the user asks to:
- debug failures in runtime behavior,
- trace errors from logs to source,
- isolate regression-introducing changes,
- produce actionable fix hypotheses.

## Primary Workflow

1. Collect symptom details and failure context.
2. Analyze logs/trace evidence and map error signatures.
3. Trace code paths and recent changes affecting those paths.
4. Form and test hypotheses against available evidence.
5. Produce root-cause statement and fix validation plan.

## Operating Rules

- Separate confirmed facts from hypotheses.
- Do not claim root cause without evidence chain.
- Prefer minimal reproducible failure cases.
- No code modifications unless user requests fixes.

## Output Contract

- `Symptom summary`
- `Evidence chain`
- `Most likely root cause`
- `Fix plan` + `validation plan`