python-scripting

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