Agent skill · Testing & QA

debugging

MUST USE for any real runtime debugging across ANY language or binary — crashes, silent failures, wrong responses, stuck processes, memory leaks, async misbehavior, unexplained timing, reverse engineering. Runs a hypothesis-driven loop: form ≥3 hypotheses, investigate in parallel, after 2 failed rounds spawn Oracles from orthogonal angles, confirm root cause, lock with a failing test, fix minimally, QA by actually USING the system, scrub artifacts. The actual HOW lives in `references/` — READ THEM. Triggers: 'debug this', 'why is X not working', 'hanging', 'attach a debugger', 'reverse enginee

YeonGyu-Kim69,732★ · +488/wk · 2 repos on radarProfile →
claude-codecodexcursorNOASSERTION
Install
npx skills add code-yeongyu/oh-my-openagent --skill debugging --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 20
SKILL.md size: 12 KB
Bundled scripts: none
Path: packages/shared-skills/skills/debugging/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 67,209 · +483 this week
Language: TypeScript
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# Debugging You are a hypothesis-driven debugger. Two disciplines apply regardless of language, runtime, or whether you have source: 1. **Runtime truth beats code reading.** Every claim about why the bug happens must come from observed state — never from a plausible story spun from reading code. 2. **Leave no trace.** Debugging creates artifacts. Every artifact is journaled and removed before you call the task done. The rest of this file is a map. **The knowledge is in `references/`.** This file cannot teach you how to debug — it can only tell you which reference will, for your exact situation. --- # 🚨 READ THE REFERENCES. THIS IS NOT OPTIONAL. > **This skill is intentionally small.** Ninety percent of what you need to know lives in `references/`. If you skim this file and start working without opening the references, you will reattach a debugger the wrong way, miss a silent-failure pattern you've never seen before, waste an hour on a source-map gotcha, or invent a worse version of a tool that already solves your problem. > > **Every reference below is mandatory when its scenario applies.** "I know this language" is not an exemption. The references exist because every runtime and

What's inside
Steps it walks through
  1. Runtime Setup — MANDATORY READING BEFORE ATTACHING
  2. Specialist Tools — ACTIVELY USE WHEN THE SCENARIO FITS
  3. The Phase Loop — READ THE REFERENCE FOR THE PHASE YOU ARE ENTERING
  4. Cross-cutting methodology references
  5. Non-Negotiable Safety Invariants
  6. What to Do Right Now
Ships with 19 files
  • references/methodology/00-setup.md
  • references/methodology/02-investigate.md
  • references/methodology/03-flaky-triage.md
  • references/methodology/04-oracle-triple.md
  • references/methodology/05-escalate.md
  • references/methodology/06-fix.md
  • references/methodology/08-qa.md
  • references/methodology/09-cleanup.md
  • references/methodology/partial-runtime-evidence.md
  • references/runtimes/bundled-js-binary.md
  • references/runtimes/go.md
  • references/runtimes/native-binary.md
  • references/runtimes/node.md
  • references/runtimes/python.md
  • references/runtimes/rust.md
  • references/tools/ghidra.md
  • references/tools/playwright-cli.md
  • references/tools/pwndbg.md
  • references/tools/pwntools.md
More from oh-my-openagent
All skills →
About this skill
What does the debugging skill do?

MUST USE for any real runtime debugging across ANY language or binary — crashes, silent failures, wrong responses, stuck processes, memory leaks, async misbehavior, unexplained timing, reverse engineering. Runs a hypothesis-driven loop: form ≥3 hypotheses, investigate in parallel, after 2 failed rounds spawn Oracles from orthogonal angles, confirm root cause, lock with a failing test, fix minimally, QA by actually USING the system, scrub artifacts. The actual HOW lives in `references/` — READ THEM. Triggers: 'debug this', 'why is X not working', 'hanging', 'attach a debugger', 'reverse enginee

How do I install it?

Run `npx skills add code-yeongyu/oh-my-openagent --skill debugging --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From code-yeongyu/oh-my-openagent, a repository with 67,209 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going