Skill40.2k repo starsupdated 5d ago

debug

The debug skill guides systematic diagnosis of Claude Code session and repository problems by examining logs, traces, and project state to isolate root causes from symptoms. Use it when encountering workflow breakage, runtime errors, or confusing behavior where the underlying issue is unclear, prioritizing examination of actual evidence over speculation and recommending minimal corrective steps.

View source Repository: oh-my-claudecode

Install in Claude Code

Copy

git clone --depth 1 https://github.com/Yeachan-Heo/oh-my-claudecode /tmp/debug && cp -r /tmp/debug/skills/debug ~/.claude/skills/debug

Then start a new Claude Code session; the skill loads automatically.

Definition

SKILL.md

# 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