What problem does it solve?
This skill eliminates the friction of debugging Python code across local interactive sessions, remote headless processes, failing tests, and post-mortem exception analysis, removing the need for guesswork when tracing runtime behavior.
Core Features & Use Cases
- Local Interactive Debugging: Use built-in breakpoint() and pdb for quick, no-setup inspection of code execution and variable state.
- Remote Process Debugging: Attach to long-running VIGIL services like gateways and subprocesses without restarting them using debugpy or remote-pdb.
- Test & Post-Mortem Debugging: Debug failing pytest tests and inspect local variables at the site of unhandled exceptions in production-like code.
- Use Case: If a VIGIL _SlashWorker subprocess is returning incorrect results, use this skill to attach a remote debugger to the running process and inspect its runtime state without disrupting active sessions.
Quick Start
Use the python-debugpy skill to debug the failing pytest test by attaching a pdb session at the point of failure to inspect variable state and execution flow.