{ "markdown": "

\n \"debug-skill\"\n

\n\n

\n Let your coding agent debug like a human developer.
\n Set breakpoints, step through code, evaluate expressions — the way you actually debug.\n

\n

\n \"Latest\n \"Build\n \"Go\n \"License:\n \"GitHub\n

\n\n

\n If this saves you a debugging session, please star the repo — it helps others find it.\n

\n\n---\n\nAI coding agents (Claude Code, Codex, Opencode, Cursor) are stuck with `print` statements and guesswork. **debug-skill**\ngives them what human developers have: a real debugger they can actually use. It ships two things:\n\n- **A Claude Code skill** — teaches Claude *how* to debug: when to set breakpoints, how to step through code, how to\n inspect state\n- **The `dap` CLI** — a stateless CLI wrapper around\n the [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) so any agent can drive a real\n debugger from Bash\n\n---\n\n## Demo\n\n[![Watch the demo](.github/demo.gif)](https://youtu.be/ZxXvTtilZr0)\n\n---\n\n## The Skill\n\n> Install the skill, and Claude debugs your code the way *you* would — not with print statements.\n\nThe `debugging-code` skill gives Claude structured knowledge of the debugging workflow: setting breakpoints, stepping\nthrough execution, inspecting locals and the call stack, evaluating expressions mid-run. It uses the `dap` CLI as its\ntool.\n\n### Install for Claude Code\n\nVia the plugin marketplace — no manual setup needed:\n\n```\n/plugin marketplace add AlmogBaku/debug-skill\n/plugin install debugging-code@debug-skill-marketplace\n```\n\n### Install for other agents\n\nVia [skills.sh](https://skills.sh) — works with Cursor, GitHub Copilot, Windsurf, Cline,\nand [20+ more agents](https://skills.sh/docs):\n\n```bash\nnpx skills add AlmogBaku/debug-skill\n# or: bunx skills add AlmogBaku/debug-skill\n```\n\nOr manually copy `skills/debugging-code/` into your agent's skills.\n\n---\n\n## The `dap` CLI\n\n`dap` wraps the Debug Adapter Protocol behind simple, stateless CLI commands. A background daemon holds the session; the\nCLI sends one command and gets back the full context — no interactive terminal required.\n\n### Install\n\n\n```bash\n# One-liner (Linux & macOS)\nbash <(curl -fsSL https://raw.githubusercontent.com/AlmogBaku/debug-skill/master/skills/debugging-code/scripts/install-dap.sh)\n```\n\n
\nOther install methods\n\n**From Homebrew (for macOS):**\n```bash\nbrew install AlmogBaku/tap/dap\n```\n\n**From sources:**\n```bash\n# Go install\ngo install github.com/AlmogBaku/debug-skill/cmd/dap@latest\n```\n\nOr download a pre-built binary from the [releases page](https://github.com/AlmogBaku/debug-skill/releases/latest).\n\n
\n\n### Quick Start\n\n```bash\ndap debug app.py --break app.py:42 # start, stop at breakpoint\ndap eval \"len(items)\" # inspect a value\ndap inspect data --depth 2 # expand nested objects\ndap step # step over\ndap continue # next breakpoint\ndap continue --to app.py:50 # run to specific line\ndap pause # interrupt if hanging\ndap restart # re-run, preserving breakpoint changes\ndap stop # end session\n```\n\nExecution commands (`debug`, `continue`, `step`) return **full context automatically**: current location, surrounding source, local variables, call stack,\nand program output. No follow-up calls needed.\n\n### Usage Examples\n\n```bash\n# Python\ndap debug app.py --break app.py:42\n\n# Go\ndap debug main.go --break main.go:15\n\n# Node.js / TypeScript\ndap debug server.js --break server.js:10\n\n# Rust / C / C++\ndap debug hello.rs --break hello.rs:4\n\n# Attach to a remote debugger (e.g. debugpy in a container)\ndap debug --attach container:5678 --backend debugpy --break handler.py:20\n\n# Attach to a running process by PID\ndap debug --pid 12345 --backend debugpy\n\n# Pass arguments to the program\ndap debug app.py --break app.py:10 -- --config prod.yaml --verbose\n```\n\n### Commands\n\n| Command | Description |\n|--------------------------------------|----------------------------------------------------------------|\n| `dap debug