Python Scripting Skill
Creates self-contained Python scripts using uv and PEP 723 inline script metadata.
What This Skill Does
-
Creates standalone Python scripts
-
Uses PEP 723 inline dependencies
-
Sets up argument parsing
-
Handles input/output
-
Configures reproducible builds
When to Use
-
Standalone utility scripts
-
One-off automation tasks
-
Quick data processing
-
CLI tools
-
Scripts that need dependencies
Reference Files
- references/UV_SCRIPT.template.py
- Python script template with PEP 723 metadata
PEP 723 Format
#!/usr/bin/env -S uv run --script
/// script
requires-python = ">=3.12"
dependencies = [
"requests",
"rich",
]
///
Running Scripts
uv run script.py [args]
Dependencies install automatically on first run.
Best Practices
-
Use exclude-newer for reproducibility
-
Include docstring with usage examples
-
Use argparse for CLI arguments
-
Return exit codes (0 success, non-zero error)
-
Keep scripts focused on one task