AgentSkillsCN

python-scripting

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

SKILL.md
--- frontmatter
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

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