python-debugpy
Debug Python: pdb REPL + debugpy remote (DAP).
npx skills add HezaoHezao/poirot --skill python-debugpy --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# Python Debugger (pdb + debugpy) ## Overview Three tools, picked by situation: | Tool | When | |---|---| | **`breakpoint()` + pdb** | Local, interactive, simplest. Add `breakpoint()` in source, run, get REPL. | | **`python -m pdb`** | Launch script under pdb with no source edits. | | **`debugpy`** | Remote / headless / attach to running process. DAP, scriptable. | **Start with `breakpoint()`.** It's the cheapest thing that works. ## When to Use - A test fails and the traceback doesn't reveal why a value is wrong - You need to step through a function and watch a collection mutate - A long-running process misbehaves and you can't restart it - Post-mortem: an exception fired and you want to inspect locals at crash site - A subprocess is the actual bug site **Don't use for:** things `print()` / `logging.debug` solve in under a minute, or things `pytest -vv --tb=long --showlocals` already reveals. ## pdb Quick Reference Inside any pdb prompt (`(Pdb)`): | Command | Action | |---|---| | `h` / `h cmd` | help | | `n` | next line (step over) | | `s` | step into | | `r` | return from current function | | `c` | continue | | `unt N` | continue until line N | | `j N` | jump to line N (same func
- Overview
- When to Use
- pdb Quick Reference
- Using breakpoint()
- Using python -m pdb (no source edits)
- Post-mortem debugging
- debugpy (remote attach)
- Common Debugging Patterns
- Watch a variable change
- Conditional breakpoint
- Inspect a running subprocess
- Pitfalls
python script.py Pauses at breakpoint(), (Pdb) prompt appears python -m pdb script.py Starts paused at first line python -m pdb -c continue script.py Runs until exception, then drops to pdb at the crash Install pip install debugpy Option 1: Launch with debugpy python -m debugpy --listen 5678 --wait-for-client script.py
What does the python-debugpy skill do?
Debug Python: pdb REPL + debugpy remote (DAP).
How do I install it?
Run `npx skills add HezaoHezao/poirot --skill python-debugpy --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 HezaoHezao/poirot, a repository with 139 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.