writing-python-scripts
Installation
SKILL.md
Writing Python Scripts
Single-file scripts use PEP 723 inline metadata for dependencies, executed via uv run --script. All type safety and error handling rules from writing-python-code still apply.
When to Use Single Script
| Single Script (PEP 723) | Full Project |
|---|---|
| One task, one file | Multiple features |
| No tests needed | Tests required |
| Templating / generation / automation | Application with UI or API |
Run directly: ./script.py |
Run via: uv run poe app |
| Dependencies in script header | Dependencies in pyproject.toml |
| Under ~500 lines | Will grow beyond ~500 lines |