● Community
AlmogBaku
⚡ Instant
Debug Skill
by AlmogBaku · AlmogBaku/debug-skill
Real-debugger skill: breakpoints, stepping, variable inspection.
Most agents 'debug' by printing. This skill actually attaches a debugger (delve, debugpy, gdb) and exposes step/continue/inspect to Claude. Useful for nasty bugs where 'add a log' loops forever.
Why use it
Key features
- Real debuggers: delve (Go), debugpy (Python), gdb (C/C++)
- Breakpoints by file:line or by symbol
- Step into / over / out
- Variable inspection (locals, args, fields)
- Watch expressions
Live Demo
What it looks like in practice
debug-skill.replay
▶ ready
Use Cases
Real-world ways to use Debug Skill
When to use: A specific input causes a panic and you can't see where without a debugger.
Prerequisites
- Server/skill installed and authenticated — See repo README
Flow
-
Reproduce under debugger
Using the debug skill, run main_test.go::TestPanicCase under delve with a breakpoint at the panic frame.✓ Copied
→ Process paused at the panic
-
Inspect
Print locals and the call chain. Show me which variable is nil.✓ Copied
→ Variable value + caller chain
Outcome: Bug located, not guessed.
Pitfalls
- Breakpoints by symbol can match multiple methods in Go interfaces — Breakpoints by symbol can match multiple methods in Go interfaces — qualify with the package path.
Cost & Limits
What this costs to run
- API quota
- See provider docs for rate limits
- Tokens per call
- Varies by tool
- Monetary
- See repo README for pricing details
- Tip
- Cache tool results and avoid repeated identical calls.
Security
Permissions, secrets, blast radius
Credential storage: Use environment variables; never commit secrets
Data egress: Tool calls go to the provider's API as documented
Troubleshooting
Common errors and fixes
delve not found
Install delve: go install github.com/go-delve/delve/cmd/dlv@latest.
Verify: dlv version
debugger detaches randomly
Long pauses can hit the IDE's heartbeat. Use the skill's --no-heartbeat option for slow flows.
Verify: Set the flag and retry
Alternatives
Debug Skill vs others
| Alternative | When to use it instead | Tradeoff |
|---|
| ad-hoc print debugging | Trivial bugs | Faster setup; doesn't scale to hard bugs |