Stats
Actions
Tags
From uv-features
This skill should be used when writing a Python script that uses uv, or when the user mentions "uv run", "PEP 723", "uv run --with", "inline script metadata". Guides writing self-contained Python scripts with inline dependency metadata.
How this skill is triggered — by the user, by Claude, or both
Slash command
/uv-features:uv-pep723The summary Claude sees in its skill listing — used to decide when to auto-load this skill
| Situation | Approach |
| Situation | Approach |
|---|---|
| Project dependencies are sufficient | uv run script.py — no PEP 723 needed |
| Needs extra deps + throwaway or rarely-run | PEP 723 inline metadata in the script |
| Temporarily try a package (debugging, etc.) | uv run --with pkg script.py |
| Core workflow script (CI, deploy, build) | Add deps to pyproject.toml, not PEP 723 |
Use PEP 723 to keep pyproject.toml clean by not adding dependencies that most workflows don't need.
Always include a shebang and PEP 723 metadata block at the top:
#!/usr/bin/env -S uv run --script
# /// script
# requires-python = ">=3.12"
# dependencies = [
# "requests",
# "rich",
# ]
# ///
import requests
from rich.pretty import pprint
resp = requests.get("https://example.com/api")
pprint(resp.json())
After chmod +x, the script is directly executable. uv resolves and installs dependencies automatically.
If more detail is needed, consult: https://docs.astral.sh/uv/guides/scripts/#using-a-shebang-to-create-an-executable-file
npx claudepluginhub pokutuna/claude-plugins --plugin uv-featuresRuns Python scripts with uv supporting PEP 723 inline dependencies, temporary --with packages, and ephemeral uvx tools. Use for quick script execution without virtualenvs.
Creates self-contained Python scripts with inline PEP 723 dependencies for UV execution via `uv run`. Includes shebangs, templates, and examples for CLI apps and data tasks.
Run Python scripts with automatic dependency management using uv. Use when executing Python code that may have package dependencies, when the user doesn't have a Python environment set up, or when you need isolated script execution without polluting system packages. Handles dependency installation automatically—no manual pip install or virtual environment setup required.