About uv
A policy skill for Python development with uv, intended for workflows that follow shared engineering standards. It sets rules for dependency management, script execution, and TOML file handling, and points to external uv references.
Key features
- 01Align Python architecture, typing, and testing
- 02Use uv add, uv sync, and uv run
- 03Specify a PEP 723 script shebang
- 04Require text mode with tomlkit
- 05Link to uv docs and migration guides
Use cases
- 01Add or synchronize dependencies in a Python project
- 02Run Python code and scripts with uv
- 03Read or write TOML configuration using tomlkit
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ jamie-bitflight/ claude_skills --skill uvAfter installing, type/uvin Claude Code to confirm it loaded.
Details
From the project READMEuv — Policy
Precedence: this policy (below) > astral:uv (if installed) / live docs.astral.sh for command
syntax, migration tables, and general usage (not duplicated here).
Policy
- Follow
python-engineering:standards-for-python-developmentfor shared architecture, typing, testing, and CLI rules. - Use
uv add/uv sync/uv runfor all Python work — neveruv pip install,uv venv, orsource .venv/bin/activate. Auv.lock-managed project with PEP 723 scripts never needs the pip-compatible lane Astral documents. - Portable PEP 723 script shebang:
#!/usr/bin/env -S uv run --quiet --script. Omit--activeunless the script is intentionally coupled to the caller's activated virtual environment. - Use text mode (
'r'/'w') withtomlkit, never binary mode ('rb'/'wb') — binary mode returnsbytes, whichtomlkitcannot parse or write.
External Resources (if astral:uv isn't installed)
Comments
Markdown supported