debug

Diagnose OMC/Claude-Code session failures by analyzing logs, traces, and state.

1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill debug-leap0920
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: debug
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/cache/omc/oh-my-claudecode/4.14.0/skills/debug
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill debug-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It helps you diagnose confusing OMC/Claude-Code session issues by turning noisy symptoms into evidence-backed next steps.

Core Features & Use Cases

  • Evidence-first diagnosis: Prioritizes trace/state and relevant session memory over guesses to isolate the true failure signal.
  • Targeted reproduction: Narrows the problem and reproduces it only as far as needed to confirm or falsify hypotheses.
  • Actionable correction: Separates symptoms from root cause and recommends the smallest next fix or verification step.

Quick Start

Use the debug skill when your OMC/Claude-Code run behaves unexpectedly and you need a clear, evidence-based explanation of what failed and what to do next.

Frequently Asked Questions about debug

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find the root cause of confusing OMC or Claude-Code session failures?

Diagnosing confusing OMC or Claude-Code session failures requires analyzing logs, traces, and state to isolate the true failure signal, turning noisy symptoms into evidence-backed explanations of what failed.

What is the best way to diagnose workflow breakage in orchestrated agent flows?

The best way to diagnose workflow breakage in orchestrated agent flows is through targeted reproduction that narrows the problem and reproduces it only as far as needed to confirm or falsify hypotheses.

How do I trace runtime behavior issues in Claude-Code using evidence instead of speculation?

To trace runtime behavior issues in Claude-Code using evidence, prioritize trace and state surfaces alongside relevant session memory to separate symptoms from the actual root cause.

Can I use trace analysis to fix unpredictable agent-flow issues during an OMC session?

Yes, you can use trace analysis to fix unpredictable agent-flow issues by examining session state and applying focused reproduction to confirm the observed failure and recommend the smallest next fix.

When should I not use targeted reproduction for debugging Claude-Code issues?

You should not use targeted reproduction for debugging Claude-Code issues when you lack accessible trace or state surfaces to verify the hypothesis, as evidence-first diagnosis depends on real data over speculation.