python-scripting

name	python-scripting
description	Python scripting with uv and PEP 723 inline dependencies. Use when creating standalone Python scripts with automatic dependency management.
author	Joseph OBrien
status	unpublished
updated	2025-12-23
version	1.0.1
tag	skill
type	skill

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