python-debugpy

Debug Python processes locally and remotely via pdb and debugpy.

7|1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/paxlabs-inc/ion-agent --skill python-debugpy-paxlabs-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/paxlabs-inc/ion-agent/tree/main/skills/software-development/python-debugpy
Command: npx skills add https://github.com/paxlabs-inc/ion-agent --skill python-debugpy-paxlabs-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires debugpy, remote-pdb, and includes scripts (resource) components.

What problem does it solve?

This skill resolves complex Python runtime issues by providing a structured approach to inspecting state, tracing execution, and attaching debuggers to both local and remote processes.

Core Features & Use Cases

  • Interactive Debugging: Use breakpoint() for immediate, local REPL access to inspect variables and mutate state during execution.
  • Remote/Headless Debugging: Utilize debugpy to attach to long-running processes or remote environments via the Debug Adapter Protocol (DAP).
  • Post-Mortem Analysis: Inspect the call stack and local variables after an unhandled exception occurs to identify the root cause of crashes.

Quick Start

Use the python-debugpy skill to set a breakpoint in your script and initiate an interactive debugging session.

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 remote Python process running in a headless environment?

Remote Python debugging uses debugpy to attach to headless processes via the Debug Adapter Protocol. You initiate a DAP connection to monitor and inspect the long-running process remotely.

What is the best way to inspect local variables after a Python crash?

Post-mortem analysis inspects the call stack and local variables after an unhandled Python exception occurs. This approach identifies the root cause of crashes by examining the program state at the moment of failure.

Can I use breakpoint() for interactive Python debugging?

Yes, interactive Python debugging uses breakpoint() for immediate local REPL access. You can inspect variables and mutate state directly during script execution using standard Python debugging libraries.

What's the difference between pdb and debugpy for Python debugging?

pdb provides local interactive inspection and REPL access, while debugpy enables remote attachment to headless processes via the Debug Adapter Protocol. Both are standard Python debugging libraries integrated for different execution contexts.

Do I need terminal access to manage Python breakpoints with debugpy?

Yes, terminal access is required to manage Python breakpoints and DAP connections effectively. This access facilitates interactive inspection, remote process monitoring, and post-mortem exception analysis.