Debug python error

Skill siddhu1716/LearnKit/skills/coding/debug_python_error

LIA Labs / Learnkit - "Make your AI agents Learn Improve and Adapt".

Install

npx -y skills add siddhu1716/LearnKit --skill debug_python_error

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

1.6 KB, as published. Nobody here has run it

Debug Python Error

When to use this skill

Diagnose and resolve a Python runtime error, traceback, or unexpected behavior by systematically isolating the root cause and applying the minimal fix.

Approach

Read the full traceback from bottom to top — identify the exception type and line
Reproduce the error in isolation with a minimal test case
Check for common causes: import errors, type mismatches, concurrency issues
Inspect the call stack for unexpected state mutations
Apply the minimal fix and verify with the original failing case
Add a regression test to prevent recurrence

Tools used

pdb: interactive debugger for stepping through execution
pytest: run targeted test to reproduce and verify fix
traceback: format and analyze exception chains

Known constraints

Always reproduce before fixing — never guess-fix
Prefer minimal changes over refactoring during debugging
Document the root cause in the commit message

Known failure modes

Fixing the symptom instead of the root cause (e.g., catching an exception instead of preventing it)
Using fork start method on macOS (use spawn instead for multiprocessing)
Missing transitive dependency errors masked by dev environment
Circular import issues hidden by lazy imports

Examples

Good output pattern

Root cause: Pool.map() hangs on macOS because the default start method is fork, which is unsafe with threads. Fix: Set mp.set_start_method("spawn") before creating the pool. Regression test: Added test_pool_spawn_method() to verify spawn is used.

Bad output pattern

"I added a try/except around the error so it doesn't crash anymore."