Smart File Writer
foryourhealth111-pixel/Vibe-Skills
Diagnoses why a file write failed (permissions, disk space, path length, locks, read-only mounts) before retrying, instead of repeating the same call blindly.
Runs a Python script with checks first: confirms the interpreter version, compiles it for syntax errors, verifies imports, then explains any traceback in plain language.
Install Python Script Runner
$ npx skills add congchuanling-dot/Cohort --skill python-run -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install congchuanling-dot/Cohort python-run --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cohort/skills/python-run .claude/skills/python-run && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .claude/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-runType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add congchuanling-dot/Cohort --skill python-run -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install congchuanling-dot/Cohort python-run --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .agents/skills && cp -r skills-src/.cohort/skills/python-run .agents/skills/python-run && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .agents/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add congchuanling-dot/Cohort --skill python-run -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install congchuanling-dot/Cohort python-run --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/.cohort/skills/python-run .cursor/skills/python-run && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .cursor/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/congchuanling-dot/Cohort.git --path .cohort/skills/python-run--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add congchuanling-dot/Cohort --skill python-run -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install congchuanling-dot/Cohort python-run --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/.cohort/skills/python-run .gemini/skills/python-run && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .gemini/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install congchuanling-dot/Cohort python-runInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add congchuanling-dot/Cohort --skill python-run -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .github/skills && cp -r skills-src/.cohort/skills/python-run .github/skills/python-run && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .github/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add congchuanling-dot/Cohort --skill python-run -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install congchuanling-dot/Cohort python-run --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/congchuanling-dot/Cohort.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/.cohort/skills/python-run .opencode/skills/python-run && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "python-run" agent skill from https://github.com/congchuanling-dot/Cohort/tree/master/.cohort/skills/python-run into .opencode/skills/python-run/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "python-run", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
python-run- GitHub stars
- 199
- Token cost
- ~577 tokens
- SKILL.md length
- 216 words
- Files
- 1
- Skills in repo
- 2
- Repo updated
- First seen
- Licence
- MIT
At a glance
Runs a Python script with checks first: confirms the interpreter version, compiles it for syntax errors, verifies imports, then explains any traceback in plain language.
- Works in 4 steps: Pre-flight → Dependency check → Execute → …
- Running a Python script and getting a clear explanation if it fails
- SKILL.md covers Rules, Process and Examples
- Calls python3
What it does
The skill wraps a short routine around running a .py file. It checks python3 --version, runs py_compile to catch syntax errors (stopping with the line number if that fails), scans the imports and tests each top-level module so missing packages are listed before the run, then executes the script with its arguments and captures stdout and stderr.
When a script fails, the agent identifies the error type, points to the line, explains the likely cause in plain language and proposes a fix without applying it. It never runs scripts as root or with sudo, flags anything that runs longer than 30 seconds and asks before extending, and edits a script without approval only for a trivial syntax fix.
When your agent uses it
- Running a Python script and getting a clear explanation if it fails
- Checking that a script's imports are installed before running it
- Debugging a .py file that raises a traceback
Example prompts
- “Run backup_photos.py and tell me if any packages are missing.”
- “Execute goldbach.py with the argument 100 and show me the output.”
- “Debug broken.py; it throws a TypeError and I can't tell why.”
Requirements
- Python 3 available as python3
- Pre-approved tools (allowed-tools): Bash, Read, Write
Workflow steps
4 steps, taken from the step headings in SKILL.md.
What it can do on your machine
Read from SKILL.md and the folder at commit a0479a6. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
BashReadWrite
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Python Script Runner loads about 577 tokens when it runs. Until then it costs about 60 tokens; SKILL.md has 216 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: notes
The automated check noted patterns worth knowing about, such as sudo or a known installer.
- NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
allowed-tools: Bash, Read, Write
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from congchuanling-dot/Cohort at commit a0479a6, republished under its MIT licence (© congchuanling-dot). 216 words, ~577 tokens.
Download SKILL.mdSave it as
.claude/skills/python-run/SKILL.md (or your agent's skills folder).- name
- python-run
- description
- Run 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.
- allowed-tools
- Bash, Read, Write
- user-invocable
- true
- argument-hint
- [script.py] [args...]
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`© congchuanling-dot, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in .cohort/skills/python-run of congchuanling-dot/Cohort.
Open the folder on GitHubat commit a0479a6
Compare with similar skills
Python Script Runner next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Python Script Runner this skillcongchuanling-dot/Cohort | 199 | — | ~577 | Automated safety check: Notes | MIT | |
| Smart File Writerforyourhealth111-pixel/Vibe-Skills | 3.6k | — | ~2.6k | Automated safety check: Pass | Apache-2.0 | |
| Code Execution Fallback and Path AnchoringHKUDS/OpenSpace | 7.7k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Native Data FetchingCherryHQ/cherry-studio-app | 4k | 6 repos | ~2.9k | Automated safety check: Notes | MIT | |
| LangBot Plugin Developmentlangbot-app/LangBot | 18k | — | ~3.9k | Automated safety check: Pass | Apache-2.0 | |
| Python Performance Optimizationwshobson/agents | 40k | 12 repos | ~814 | Automated safety check: Pass | MIT |
Similar skills
Code Execution Fallback and Path Anchoring
HKUDS/OpenSpace
Fallback ladder for failed sandboxed code runs, plus the habit of fixing the working directory first so generated files land in the right place.
Native Data Fetching
CherryHQ/cherry-studio-app
A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.
LangBot Plugin Development
langbot-app/LangBot
Guides building, debugging and testing LangBot plugins: components, SDK calls, README and locale rules, SDK pitfalls and WebSocket-based testing.
Python Performance Optimization
wshobson/agents
Profiles slow Python code with cProfile and memory profilers, then applies targeted fixes for CPU, memory, I/O and query bottlenecks.
Git History Bug Audit
ben-manes/caffeine
Audits a module by walking its git history commit by commit, tracking unresolved issues forward, and reporting the ones that survive to HEAD as findings.
More from congchuanling-dot/Cohort
Atomic Git Commit
congchuanling-dot/Cohort
Creates atomic git commits with Conventional Commits messages, staging specific files and adding a short prose body only when a decision needs explaining.
Related
Works with
Categories
Questions about Python Script Runner
What does Python Script Runner do?
Runs a Python script with checks first: confirms the interpreter version, compiles it for syntax errors, verifies imports, then explains any traceback in plain language. py file. It checks python3 --version, runs py_compile to catch syntax errors (stopping with the line number if that fails), scans the imports and tests each top-level module so missing packages are listed before the run, then executes the script with its arguments and captures stdout and stderr.
When should I use Python Script Runner?
Python Script Runner fits situations like: running a Python script and getting a clear explanation if it fails; checking that a script's imports are installed before running it; debugging a .py file that raises a traceback.
How do I install Python Script Runner in Claude Code?
Run `npx skills add congchuanling-dot/Cohort --skill python-run -a claude-code`. Or copy the skill folder (.cohort/skills/python-run in congchuanling-dot/Cohort) into .claude/skills/python-run in your project. Claude Code loads it when a task matches its description.
How do I install Python Script Runner in Codex?
Run `npx skills add congchuanling-dot/Cohort --skill python-run -a codex`. Or copy the skill folder (.cohort/skills/python-run in congchuanling-dot/Cohort) into .agents/skills/python-run in your project. Codex loads it when a task matches its description.
Can I use Python Script Runner in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add congchuanling-dot/Cohort --skill python-run -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/python-run, .gemini/skills/python-run, .github/skills/python-run and .opencode/skills/python-run in your project.
What does Python Script Runner need to run?
Going by SKILL.md and its folder, Python Script Runner needs the command-line tools its instructions call (python3). Our summary lists: Python 3 available as python3. Its frontmatter pre-approves these tools: Bash, Read, Write.
Does Python Script Runner access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Python Script Runner safe to install?
Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.
What licence does Python Script Runner use?
Python Script Runner is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Python Script Runner use?
About 577 tokens (SKILL.md is roughly 2.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Python Script Runner?
Skills that share tags, products or a category with Python Script Runner: Smart File Writer (foryourhealth111-pixel/Vibe-Skills, 3.6k stars), Code Execution Fallback and Path Anchoring (HKUDS/OpenSpace, 7.7k stars), Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars) and LangBot Plugin Development (langbot-app/LangBot, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Python Script Runner?
congchuanling-dot (a GitHub user) maintains it in congchuanling-dot/Cohort, which has 199 GitHub stars. The repository holds 2 skills in this directory. The repository was last updated on August 15, 2026.
Source: congchuanling-dot/Cohort on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.