uv-expert

Expert guidance for the uv Python package manager. Use this skill when installing packages, managing virtual environments, setting up Python projects, configuring pyproject.toml, migrating from pip or poetry, or pinning Python versions — prefer it over generic pip advice for any uv-related task.

Execute the uv related task described in $ARGUMENTS.

Steps

If $ARGUMENTS is empty, report an error requesting a description of the desired Python project setup or dependency task.
Read $SKILL_DIR/references/QUICK_REFERENCE.md for essential uv commands, migration cheatsheets, and project structure.
If the task involves a concrete workflow (web project, data science, workspaces, migration), consult $SKILL_DIR/references/EXAMPLES.md for step-by-step examples.
Execute the appropriate uv commands using the bash tool to accomplish the user's goal.
Verify the environment or dependencies have been set up correctly.

Output

A summary of the executed uv commands and the final state of the project or environment.

Examples

User Request: "Initialize a new Python project with pytest using uv." Response: Run uv init my-project, cd my-project, and uv add pytest --dev. Inform the user that the project is ready.

Troubleshooting

If cache corruption occurs, run uv cache clean.
If there are Python version conflicts, use uv python pin to set the correct version.