python-debugpy

Debug Python code across local, remote, post-mortem, and test scenarios.

1|Updated Jun 25, 2026
One-click install
npx skills add https://github.com/Signmanal/VIGIL --skill python-debugpy-signmanal
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/Signmanal/VIGIL/tree/main/skills/software-development/python-debugpy
Command: npx skills add https://github.com/Signmanal/VIGIL --skill python-debugpy-signmanal

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires pytest, pytest-xdist, and includes scripts (resource) components.

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.

Frequently Asked Questions about python-debugpy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug a long-running Python process without restarting it?

Debug pytest test failures by attaching a pdb session at the point of failure to inspect variable state and execution flow. This supports standard pytest and pytest-xdist distributed test workflows.

What is post-mortem debugging in Python and when do I need it?

Yes, DAP-based remote IDE integration is fully supported. You can attach an IDE debugger to headless Python processes using debugpy, enabling interactive inspection of remote agent workflows and subprocesses.

Can I use pdb for non-interactive terminal debugging in automated workflows?

Yes, remote-pdb enables non-interactive terminal debugging for agent workflows. It provides terminal-based inspection of Python code execution when an interactive REPL or IDE is not available.

How do I investigate an async handler deadlock in a running Python service?

Attach a remote debugger to the running Python process to investigate async handler deadlocks. This allows you to inspect the runtime state and execution flow of long-running services without restarting them.