python-debugging-expert
Master debugger for Python code with expertise in common errors, performance issues, and debugging tools
When & Why to Use This Skill
This Claude skill serves as a comprehensive Python debugging expert, designed to identify and resolve complex code errors, performance bottlenecks, and memory leaks. It leverages advanced diagnostic tools like pdb and debugpy, providing structured playbooks for triaging issues, stabilizing reproduction pipelines, and optimizing asynchronous and concurrent code for modern Python environments (including Python 3.13).
Use Cases
- Case 1: Rapidly triaging and fixing runtime exceptions and logic errors in Python scripts using structured diagnostic templates and IDE-integrated debugging tools.
- Case 2: Optimizing application performance by profiling CPU hotspots and identifying memory leaks or garbage collection issues in high-load systems.
- Case 3: Troubleshooting complex concurrency issues, such as race conditions and deadlocks in asyncio or multiprocessing environments to ensure thread safety.
- Case 4: Establishing reliable bug reproduction pipelines and automated test fixtures to prevent regression of previously resolved issues.
| name | python-debugging-expert |
|---|---|
| description | Master debugger for Python code with expertise in common errors, performance issues, and debugging tools |
| license | Proprietary |
Python Debugging Expert
Status: ✅ Research complete Last validated: 2025-11-08 Confidence: 🟡 Medium — Research-backed debugging playbook – review semi-annually
How to use this skill
- Begin with modules/core-guidance.md to triage the issue and plan reproduction.
- Use modules/diagnostics-and-tooling.md to select appropriate debuggers and tracing tools.
- Resolve concurrency issues via modules/async-and-concurrency.md.
- Address hotspots and leaks with modules/performance-and-memory.md.
- Stabilize reproduction pipelines through modules/testing-and-reproduction.md.
- Track follow-ups in modules/known-gaps.md and revisit modules/research-checklist.md every six months.
Module overview
- Core guidance — intake template, triage, communication.
- Diagnostics & tooling — pdb, debugpy, logging, tracing, IDE features.
- Async & concurrency — asyncio debugging, race detection, multiprocessing.
- Performance & memory — profiling CPU/memory, GC, leak detection.
- Testing & reproduction — fixtures, property-based tests, CI automation.
- Known gaps — future research.
- Research checklist — validation cadence.
Research status
- Updated for Python 3.13 debugging improvements, async task diagnostics, and modern tooling.
- Next review due 2026-05-01 or sooner if CPython introduces major debugging changes.
- Known gaps capture C extension debugging and distributed tracing coverage pending further work.