Skip to content
Back to search

debug-skill-marketplace

MarketplaceWorks with Claude CodeGitHub

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/almogbaku--debug-skill/badge.svg)](/listings/almogbaku--debug-skill)

HTML

<a href="/listings/almogbaku--debug-skill"><img src="/api/listings/almogbaku--debug-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Via the plugin marketplace — no manual setup needed:

/plugin marketplace add AlmogBaku/debug-skill
/plugin install debugging-code@debug-skill-marketplace

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. {
  2. "name": "debug-skill-marketplace",
  3. "owner": {
  4. "name": "Almog Baku"
  5. },
  6. "plugins": [
  7. {
  8. "name": "debugging-code",
  9. "description": "Interactively debug source code — set breakpoints, step through execution, inspect live variables, evaluate expressions, and trace root causes.",
  10. "source": "./",
  11. "skills": ["./skills/debugging-code"]
  12. }
  13. ]
  14. }
README.md · README · 212 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. <p align="center">
  2. <img src=".github/logo.png" alt="debug-skill" width="220">
  3. </p>
  4. <p align="center">
  5. <strong>Let your coding agent debug like a human developer.</strong><br>
  6. Set breakpoints, step through code, evaluate expressions — the way you actually debug.
  7. </p>
  8. <p align="center">
  9. <a href="https://github.com/AlmogBaku/debug-skill/releases/latest"><img src="https://img.shields.io/github/v/release/AlmogBaku/debug-skill?style=flat-square&color=00c853" alt="Latest Release"></a>
  10. <a href="https://github.com/AlmogBaku/debug-skill/actions/workflows/release.yml"><img src="https://img.shields.io/github/actions/workflow/status/AlmogBaku/debug-skill/release.yml?style=flat-square" alt="Build Status"></a>
  11. <a href="https://github.com/AlmogBaku/debug-skill/blob/master/go.mod"><img src="https://img.shields.io/github/go-mod/go-version/AlmogBaku/debug-skill?style=flat-square" alt="Go Version"></a>
  12. <a href="https://github.com/AlmogBaku/debug-skill/blob/master/LICENSE"><img src="https://img.shields.io/github/license/AlmogBaku/debug-skill?style=flat-square" alt="License: MIT"></a>
  13. <a href="https://github.com/AlmogBaku/debug-skill/stargazers"><img src="https://img.shields.io/github/stars/AlmogBaku/debug-skill?style=flat-square&color=yellow" alt="GitHub Stars"></a>
  14. </p>
  15. <p align="center">
  16. If this saves you a debugging session, please <a href="https://github.com/AlmogBaku/debug-skill"><strong>star the repo</strong></a> — it helps others find it.
  17. </p>
  18. ---
  19. AI coding agents (Claude Code, Codex, Opencode, Cursor) are stuck with `print` statements and guesswork. **debug-skill**
  20. gives them what human developers have: a real debugger they can actually use. It ships two things:
  21. - **A Claude Code skill** — teaches Claude *how* to debug: when to set breakpoints, how to step through code, how to
  22. inspect state
  23. - **The `dap` CLI** — a stateless CLI wrapper around
  24. the [Debug Adapter Protocol](https://microsoft.github.io/debug-adapter-protocol/) so any agent can drive a real
  25. debugger from Bash
  26. ---
  27. ## Demo
  28. [![Watch the demo](.github/demo.gif)](https://youtu.be/ZxXvTtilZr0)
  29. ---
  30. ## The Skill
  31. > Install the skill, and Claude debugs your code the way *you* would — not with print statements.
  32. The `debugging-code` skill gives Claude structured knowledge of the debugging workflow: setting breakpoints, stepping
  33. through execution, inspecting locals and the call stack, evaluating expressions mid-run. It uses the `dap` CLI as its
  34. tool.
  35. ### Install for Claude Code
  36. Via the plugin marketplace — no manual setup needed:
  37. ```
  38. /plugin marketplace add AlmogBaku/debug-skill
  39. /plugin install debugging-code@debug-skill-marketplace
  40. ```
  41. ### Install for other agents
  42. Via [skills.sh](https://skills.sh) — works with Cursor, GitHub Copilot, Windsurf, Cline,
  43. and [20+ more agents](https://skills.sh/docs):
  44. ```bash
  45. npx skills add AlmogBaku/debug-skill
  46. # or: bunx skills add AlmogBaku/debug-skill
  47. ```
  48. Or manually copy `skills/debugging-code/` into your agent's skills.
  49. ---
  50. ## The `dap` CLI
  51. `dap` wraps the Debug Adapter Protocol behind simple, stateless CLI commands. A background daemon holds the session; the
  52. CLI sends one command and gets back the full context — no interactive terminal required.
  53. ### Install
  54. ```bash
  55. # One-liner (Linux & macOS)
  56. bash <(curl -fsSL https://raw.githubusercontent.com/AlmogBaku/debug-skill/master/skills/debugging-code/scripts/install-dap.sh)
  57. ```
  58. <details>
  59. <summary>Other install methods</summary>
  60. **From Homebrew (for macOS):**
  61. ```bash
  62. brew install AlmogBaku/tap/dap
  63. ```
  64. **From sources:**
  65. ```bash
  66. # Go install
  67. go install github.com/AlmogBaku/debug-skill/cmd/dap@latest
  68. ```
  69. Or download a pre-built binary from the [releases page](https://github.com/AlmogBaku/debug-skill/releases/latest).
  70. </details>
  71. ### Quick Start
  72. ```bash
  73. dap debug app.py --break app.py:42 # start, stop at breakpoint
  74. dap eval "len(items)" # inspect a value
  75. dap inspect data --depth 2 # expand nested objects
  76. dap step # step over
  77. dap continue # next breakpoint
  78. dap continue --to app.py:50 # run to specific line
  79. dap pause # interrupt if hanging
  80. dap restart # re-run, preserving breakpoint changes
  81. dap stop # end session
  82. ```
  83. Execution commands (`debug`, `continue`, `step`) return **full context automatically**: current location, surrounding source, local variables, call stack,
  84. and program output. No follow-up calls needed.
  85. ### Usage Examples
  86. ```bash
  87. # Python
  88. dap debug app.py --break app.py:42
  89. # Go
  90. dap debug main.go --break main.go:15
  91. # Node.js / TypeScript
  92. dap debug server.js --break server.js:10
  93. # Rust / C / C++
  94. dap debug hello.rs --break hello.rs:4
  95. # Attach to a remote debugger (e.g. debugpy in a container)
  96. dap debug --attach container:5678 --backend debugpy --break handler.py:20
  97. # Attach to a running process by PID
  98. dap debug --pid 12345 --backend debugpy
  99. # Pass arguments to the program
  100. dap debug app.py --break app.py:10 -- --config prod.yaml --verbose
  101. ```
  102. ### Commands
  103. | Command | Description |
  104. |--------------------------------------|----------------------------------------------------------------|
  105. | `dap debug <script>` | Start debugging (local or `--attach host:port` or `--pid PID`) |
  106. | `dap stop` | End session |
  107. | `dap step [in\|out\|over]` | Step (default: over) |
  108. | `dap continue` | Resume execution (`--to file:line` for temp breakpoint) |
  109. | `dap context [--frame N]` | Re-fetch current state |
  110. | `dap eval <expr> [--frame N]` | Evaluate expression in current frame |
  111. | `dap inspect <var> [--depth N]` | Inspect variable (expand nested objects) |
  112. | `dap output` | Drain buffered stdout/stderr since last stop |
  113. | `dap pause` | Pause a running program |
  114. | `dap restart` | Restart session, preserving breakpoint changes |
  115. | `dap threads` | List all threads |
  116. | `dap thread <id>` | Switch to a different thread |
  117. | `dap break list\|add\|remove\|clear` | Manage breakpoints mid-session |
  118. **Global flags:** `--json` (machine-readable output), `--session <name>` (named sessions), `--socket <path>` (custom
  119. socket path), `--context-lines <int>` (lines of source context)
  120. ### Supported Languages
  121. | Language | Backend | Auto-detected |
  122. |--------------------|-------------|:-------------:|
  123. | Python | debugpy | yes |
  124. | Go | dlv (Delve) | yes |
  125. | Node.js/TypeScript | js-debug | yes |
  126. | Rust / C / C++ | lldb-dap | yes |
  127. Backend is inferred from the file extension. Override with `--backend <name>`.
  128. ### How It Works
  129. ```
  130. dap <cmd> → Unix socket → Daemon → DAP protocol → debugpy / dlv / js-debug / lldb-dap → your program
  131. ```
  132. The daemon starts automatically on `dap debug` and shuts down on `dap stop` (or after 10 min idle). It's invisible — you
  133. never manage it directly.
  134. ### Multi-Session
  135. Multiple agents can debug independently with named sessions:
  136. ```bash
  137. dap debug app.py --session agent1 --break app.py:10
  138. dap debug main.go --session agent2 --break main.go:8
  139. dap stop --session agent1 # stops agent1 only
  140. ```
  141. Each session has its own daemon and socket. Omit `--session` to use the default session.
  142. ---
  143. ## Contributing
  144. PRs and issues welcome. See `claudedocs/` for architecture details and `CLAUDE.md` for code conventions.
  145. ## Support the Project
  146. If debug-skill saves you from a painful debugging session,
  147. consider [starring the repo](https://github.com/AlmogBaku/debug-skill/stargazers) — it helps others find it and keeps
  148. the project going.
  149. ## License
  150. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.