doraemonkeys

Claude Code Debug Mode — Design skill for Claude Code

Design community

Cursor-style Debug Mode skill for coding agents.

How to install Claude Code Debug Mode

This entry records only its repository, not the path inside it, so there is no exact command to give. Open doraemonkeys/claude-code-debug-mode and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code Debug Mode does

Cursor-style Debug Mode skill for coding agents. Hypothesis-driven debugging with runtime log instrumentation and human-in-the-loop verification.

Alternatives in Design

Poco Claw — A more beautiful and easier-to-use alternative to OpenClaw 1.3k ★
Scroll Craft — Claude Code skill for premium scroll-driven websites 1k ★
Home Assistant Vibecode Agent — Home Assistant MCP server agent 617 ★

README

Debug Mode Skill (Claude Code + Codex + Gemini CLI)

A hypothesis-driven debugging skill for [Claude Code](https://docs.anthropic.com/en/docs/claude-code), Codex, and [Gemini CLI](https://github.com/google-gemini/gemini-cli). Instead of blindly guessing fixes, it instruments your code with runtime logs, generates multiple hypotheses, and iteratively narrows down the root cause — with you in the loop.

Inspired by [Cursor's Debug Mode](https://www.cursor.com/blog/introducing-debug-mode).

How It Works

Bug Report → Hypotheses → Instrument Code → Reproduce → Analyze Logs → Fix → Verify → Clean Up

Understand — Gathers context about the bug (expected vs actual behavior, repro steps)
Hypothesize — Generates 3–5 testable hypotheses about root causes
Instrument — Adds targeted debug logging wrapped in #region DEBUG blocks
Reproduce — You trigger the bug while logs are collected to .claude/debug.log
Diagnose — Maps log output to hypotheses, confirms or rules out each one
Fix — Writes a minimal, targeted fix (not a refactor)
Verify — You confirm the fix works; if not, the cycle repeats
Clean up — Removes all instrumentation, leaving a clean diff

Install

One-liner (Claude Code)

# macOS / Linux / Windows (Git Bash / MSYS2)
mkdir -p ~/.claude/skills && git clone https://github.com/doraemonkeys/claude-code-debug-mode.git ~/.claude/skills/claude-code-debug-mode

# Claude Code discovers skills only ONE directory level under ~/.claude/skills/
# (it does not recurse), but this repo keeps SKILL.md inside debug-mode/. Lift that
# folder up one level, otherwise the skill silently won't load:
mv ~/.claude/skills/claude-code-debug-mode/debug-mode ~/.claude/skills/debug-mode
rm -rf ~/.claude/skills/claude-code-debug-mode

**Why the extra step (Claude only):** Codex and Gemini scan `skills/` recursively, so they find `claude-code-debug-mode/debug-mode/SKILL.md` on their own. Claude Code look