89jobrien

python-scripting

Python scripting with uv and PEP 723 inline dependencies. Use when creating

89jobrien 4 Updated 8mo ago

Resources

1
GitHub

Install

npx skillscat add 89jobrien/steve/python-scripting

Install via the SkillsCat registry.

About this skill

The skill generates standalone Python scripts that embed dependency declarations via PEP 723 and use uv for automatic dependency installation, handling argument parsing and I/O. It addresses the need for reproducible, self‑contained command‑line tools without manual environment setup. It is appropriate for creating quick utilities, automation scripts, or CLI tools that require external libraries.

SKILL.md

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