# Python Uv

> Use when creating or updating Python projects that should be managed by uv with the uv_build backend, including pyproject.toml layout, scripts entrypoints, and uv run/tool usage.

- Skill: `tomevault-io/python-uv-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/python-uv-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/python-uv-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/python-uv-2

---


# Python Uv

## Overview
Use this skill to standardize Python project setup with uv, including `pyproject.toml` fields, uv_build backend, and
CLI entry points. Prefer a `src/` layout for installable packages.

## Workflow
1) Create or update `pyproject.toml`
2) Ensure package layout (`src/`) and entry points
3) Use uv for dependency sync and executable installation

## Project Template
Use the template in `references/pyproject.toml` as the baseline. Update:
- `[project].name`, `version`, and `description`
- `dependencies`
- `[project.scripts]` entry points

## Layout Guidance
- Prefer `src/<package_name>/...` layout
- Ensure `__init__.py` exists in package dirs
- Keep CLI entry points under `src/<package_name>/cli/`

## uv Usage
- Install deps: `uv sync`
- Run without venv: `uv run <script>`
- Install CLI: `uv tool install --editable .`

## References
- `references/pyproject.toml` for the uv/uv_build template

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/jakkusakura) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->