Skip to main content

debug

Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction

Source facts

Repository
Yeachan-Heo/oh-my-claudecode
Last source activity
September 25, 2026 at 05:39
Detected SKILL.md language
English
Stars
39,789
Forks
3,563

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

Showing SKILL.md

SKILL.md
Source instructions · Read-only preview
name
debug
description
Diagnose the current OMC session or repo state using logs, traces, state, and focused reproduction
# 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. - Tag temporary debug output `[DEBUG-<4hex>]`; cleanup is then a single grep. - Redact secrets from logs and traces before they leave the session. - If the failure traces to a missing or wrong seam, say so as the finding and point at `refit` or `architecture-survey` — the environment lesson outlives the fix. ## Output - Observed failure - Root-cause hypothesis - Evidence for that hypothesis - Smallest next action
View on GitHub