SKILL.md
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](modules/core-guidance.md) to triage the issue and plan reproduction.
- Use [modules/diagnostics-and-tooling.md](modules/diagnostics-and-tooling.md) to select appropriate debuggers and tracing tools.
- Resolve concurrency issues via [modules/async-and-concurrency.md](modules/async-and-concurrency.md).
- Address hotspots and leaks with [modules/performance-and-memory.md](modules/performance-and-memory.md).
- Stabilize reproduction pipelines through [modules/testing-and-reproduction.md](modules/testing-and-reproduction.md).
- Track follow-ups in [modules/known-gaps.md](modules/known-gaps.md) and revisit [modules/research-checklist.md](modules/research-checklist.md) every six months.
Module overview
- [Core guidance](modules/core-guidance.md) — intake template, triage, communication.
- [Diagnostics & tooling](modules/diagnostics-and-tooling.md) — pdb, debugpy, logging, tracing, IDE features.
- [Async & concurrency](modules/async-and-concurrency.md) — asyncio debugging, race detection, multiprocessing.
- [Performance & memory](modules/performance-and-memory.md) — profiling CPU/memory, GC, leak detection.
- [Testing & reproduction](modules/testing-and-reproduction.md) — fixtures, property-based tests, CI automation.
- [Known gaps](modules/known-gaps.md) — future research.
- [Research checklist](modules/research-checklist.md) — 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.