mcpField
D
debug

debug

github.com/yeachan-heoAgent workflows40.4k647 installsUpdated today
Repository

About debug

debug is an OMC skill for diagnosing problems in a current OMC or Claude-Code session. It prioritizes local evidence and narrow reproduction to separate symptoms from root causes and identify a small next action.

Key features

  1. 01Inspects traces, state, and relevant tests
  2. 02Reproduces issues narrowly where possible
  3. 03Separates symptoms from root causes
  4. 04Recommends a focused fix or check
  5. 05Redacts secrets and tags temporary debug output

Use cases

  1. 01Investigating broken session workflows
  2. 02Diagnosing hooks or agent orchestration issues
  3. 03Identifying whether a failure is a runtime bug

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yeachan-heo/oh-my-claudecode --skill debug

After installing, type/debugin Claude Code to confirm it loaded.

Details

From the project 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.
  • 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

Comments

Markdown supported