uv

Wraps Python commands and package management with uv run and uvx.

3|1|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/ZHLX2005/sl --skill uv-zhlx2005
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: uv
Source: https://github.com/ZHLX2005/sl/tree/main/skills/uv
Command: npx skills add https://github.com/ZHLX2005/sl --skill uv-zhlx2005

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Python workflows often mix pip, python, and tool-specific commands inconsistently, causing broken environments and dependency conflicts. This Skill enforces uv as the single tool for all Python package management and command execution. ## Core Features & Use Cases - Mandatory Command Wrapping: Translates every Python invocation (python, pytest, dbt) into uv run or uvx equivalents. - pip Replacement Rules: Maps pip commands like pip install and pip freeze to uv add, uv pip install, and uv pip freeze. - uv run vs uvx Guidance: Distinguishes project tools that import your modules (uv run) from external utilities like linters and formatters (uvx). - Use Case: When setting up a dbt project, the Skill ensures you run uv add dbt-snowflake and uv run dbt run instead of pip and bare dbt calls. ## Quick Start Ask the assistant to install pytest and run your test suite, and it will use uv add and uv run automatically.

Frequently Asked Questions about uv

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I replace pip install with uv?

Use `uv add <package>` instead of `pip install <package>` to add dependencies to your project. For requirements files, use `uv pip install -r requirements.txt`, and use `uv pip list` or `uv pip freeze` for inspection.

When should I use uv run vs uvx?

Use `uv run` for tools that import your project modules, like pytest or your application code. Use `uvx` for external utilities like ruff, black, or mypy that analyze code without importing your modules.

How do I run dbt commands with uv?

Install dbt with `uv add dbt-snowflake` or the appropriate adapter, then prefix all dbt commands with uv run, such as `uv run dbt run`, `uv run dbt debug`, and `uv run dbt deps`.

Can I still use pip if uv is unavailable?

pip is only a fallback when the user explicitly requests it, uv is not installed on the system, or the user gives explicit confirmation. Otherwise uv is the only option for Python package management.

Should linters like ruff be run with uv run or uvx?

Prefer `uvx ruff check .` since linters are external tools that do not import your project modules. However, if the project already uses `uv run ruff`, keep that pattern for consistency.