---
name: Debug
slug: debug
category: Quality
description: Debug diagnoses current OMC or Claude Code session problems by inspecting logs, traces, state, and focused reproduction. Use it when a workflow breaks or runtime behavior is confusing and you need the root cause and smallest next fix.
github: "https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/debug"
language: TypeScript
stars: 38536
forks: 3462
install: "npx degit https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/debug ~/.claude/skills/debug"
installs_to: ~/.claude/skills/debug
source_path: skills/debug/SKILL.md
collection_size: 25
category_size: 1354
collection_url: "https://dirskills.com/collections/Yeachan-Heo/oh-my-claudecode"
added: 2026-08-13T07:37:14.783Z
last_synced: 2026-08-13T07:37:14.783Z
canonical_url: "https://dirskills.com/skills/debug"
---

# Debug

Debug diagnoses current OMC or Claude Code session problems by inspecting logs, traces, state, and focused reproduction. Use it when a workflow breaks or runtime behavior is confusing and you need the root cause and smallest next fix.

**Install:**

```bash
npx degit https://github.com/Yeachan-Heo/oh-my-claudecode/tree/main/skills/debug ~/.claude/skills/debug
```

## README

# Debug

Use this skill when the user wants help diagnosing a current OMC/Claude-Code session problem, workflow breakage, or confusing runtime behavior.

## Goal
Find the real failure signal quickly and explain the next corrective step.

## Workflow
1. Read the user’s issue description carefully.
2. Inspect the most relevant local evidence first:
   - trace tools
   - state tools
   - notepad / project memory when relevant
   - failing tests or commands
3. Reproduce the issue narrowly if possible.
4. Distinguish symptoms from root cause.
5. Recommend the smallest next fix or verification step.

## Rules
- Prefer real evidence over guesses.
- Use the trace/state surfaces when the issue involves orchestration, hooks, or agent flow.
- If the issue is actually a product/runtime bug rather than app code, say so plainly.
- Do not prescribe broad rewrites before isolating the failure.

## Output
- Observed failure
- Root-cause hypothesis
- Evidence for that hypothesis
- Smallest next action