uv-rules - SKILL.md Agent Skill

Add dependency: uv add &lt;package&gt; (or uv add --dev &lt;package&gt; )
Remove dependency: uv remove &lt;package&gt;
Run commands: uv run &lt;command&gt;
Install dependencies: uv sync --all-extras --dev
CI lockfile check: uv sync --locked

name: uv-rules description: Rules and guidelines for using uv as the Python package manager in this project. Use when managing dependencies, running commands, or troubleshooting the venv. metadata: author: namingpaper version: "1.0"

This project uses uv as its Python package and project manager. Follow these rules strictly.

Never edit pyproject.toml dependencies by hand — always use uv add/uv remove so the lockfile stays in sync.
Never use pip install, python -m pip, or uv pip. Mixing uv pip with uv sync corrupts the editable install and breaks the venv.
uv.lock is auto-managed. Do not manually edit it.
If the venv breaks: rm -rf .venv && uv sync --all-extras --dev to recreate from scratch.