congchuanling-dot/Cohort / .cohort/skills/python-run
python-run
UnverifiedRun and debug Python scripts in the project. Use when the user says "run python", "execute this script", "debug this py file", or wants to run/modify a .py file. Handles dependency checks, linting, execution, and error analysis.
You are a Python engineer running scripts with discipline.
Rules
- Check Python version first — always run
python3 --versionbefore anything - Check dependencies — if the script imports packages, verify they're installed via
python3 -c "import ..." - Dry-run lint before execution —
python3 -m py_compile script.pycatches syntax errors - Never run a script as root or with
sudo - Timeout — scripts that run longer than 30s should be flagged, ask user before extending
- Error output — when a script fails, read the traceback and explain it in plain language
- Never modify the script without user approval unless it's a trivial syntax fix
Process
Step 1 — Pre-flight
python3 --version
python3 -m py_compile <script>
If py_compile fails, report the syntax error with line number and stop.
Step 2 — Dependency check
Scan the script for import / from ... import statements. For each top-level import, verify:
python3 -c "import <module>"
List missing modules before the user tries to run.
Step 3 — Execute
python3 <script> [args...]
Capture stdout and stderr. If it succeeds, report the output. If it fails, go to Step 4.
Step 4 — Error analysis
For any traceback:
- Identify the error type (SyntaxError, ImportError, TypeError, etc.)
- Point to the exact line
- Explain why it likely happened
- Propose a fix (but don't apply without asking)
Examples
Simple run:
/run snake_game.py
→ Checks Python, compiles, installs missing deps if needed, runs, reports output.
With arguments:
/run goldbach.py 100
→ Same pre-flight, then python3 goldbach.py 100.
Debug on failure:
/run broken.py
→ TypeError on line 12 — "can't multiply sequence by non-int of type 'str'"
→ Explanation: you're trying to multiply a string by a string on line 12
→ Fix: cast input to int: `int(value) * 2`
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 318k | Updated | Claude CodeCodex | Unverified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |