fusion-tea: Skill for Claude Code

Before executing this skill, read .agentic-mbse/claude.md in Claude Code or .agentic-mbse/codex.md in Codex. Resolve supporting paths from this skill’s installed directory; keep generated outputs in the project or a temporary directory. Read referenced skills from .agents/skills/<name>/SKILL.md when their guidance is needed.

Python Debugger Skill

This skill enables programmatic debugging of Python scripts by setting breakpoints, capturing variable state, and inspecting stack traces—all without interactive terminal sessions.

Core Capability

Run scripts/claude_debugger.py to debug Python code non-interactively:

# Set breakpoints at specific lines
uv run python .agents/skills/python-debugger/scripts/claude_debugger.py target.py --breakpoints 10,25,42

# Capture state only when exceptions occur (fastest)
uv run python .agents/skills/python-debugger/scripts/claude_debugger.py target.py --trace-exceptions

# Output to file for complex analysis
uv run python .agents/skills/python-debugger/scripts/claude_debugger.py target.py -b 10,25 -o debug_state.json

Quick Reference

Line Breakpoints

uv run python .agents/skills/python-debugger/scripts/claude_debugger.py script.py --breakpoints 15,30,45

Captures at each specified line: locals (with types/values), full stack trace.

Exception Capture (Post-Mortem)

uv run python .agents/skills/python-debugger/scripts/claude_debugger.py script.py --trace-exceptions

Runs script normally. On exception: captures all frame locals, full traceback.

Limit Captures

uv run python .agents/skills/python-debugger/scripts/claude_debugger.py script.py -b 10 --max-hits 3

Stops after 3 breakpoint hits (prevents runaway loops).

Pass Script Arguments

uv run python .agents/skills/python-debugger/scripts/claude_debugger.py script.py -b 10 -- --input data.txt

Output Format

JSON output contains:

{
  "status": "completed",
  "total_hits": 3,
  "captures": [
    {
      "event": "line_breakpoint",
      "file": "/path/to/script.py",
      "line": 15,
      "function": "process_data",
      "locals": {
        "x": {"repr": "42", "type": "int", "value": 42},
        "items": {"repr": "[1, 2, 3]", "type": "list", "length": 3}
      },
      "stack_trace": [
        {"file": "script.py", "line": 15, "function": "process_data"},
        {"file": "script.py", "line": 50, "function": "main"}
      ]
    }
  ]
}