python-scripting

# 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

```python
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
#   "requests",
#   "rich",
# ]
# ///
```

## Running Scripts

```bash
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