python-scripting

89jobrien 的头像作者 89jobrien

使用 uv 和 PEP 723 内联依赖的 Python 脚本。当创建具有自动依赖管理的独立 Python 脚本时使用。

📖 中文导读:使用 uv 和 PEP 723 内联依赖的 Python 脚本。当创建具有自动依赖管理的独立 Python 脚本时使用。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

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