AgentSkillsCN

cli-uv

当用户需要协助使用 uv CLI 命令时，可使用此技能，涵盖 auth（管理身份验证）、cache（管理 uv 的缓存）、pip、python（管理 Python 版本与安装）、self（管理 uv 可执行文件）、tool、add、build、export、format、help、init、lock、publish、remove、run、sync、tree、venv、version。全面覆盖 20 条 uv 命令的标志、子命令、使用模式以及故障排除方法。

SKILL.md
--- frontmatter
name: cli-uv
description: >-
  This skill should be used when the user needs help with uv CLI commands, including auth (manage authentication), cache (manage uv's cache), pip, python (manage python versions and installations), self (manage the uv executable), tool, add, build, export, format, help, init, lock, publish, remove, run, sync, tree, venv, version. Covers flags, subcommands, usage patterns, and troubleshooting for all 20 uv commands.

uv CLI Reference

Expert command reference for uv v0.9.28.

  • •54 commands (6 with subcommands)
  • •1668 command flags + 16 global flags
  • •0 usage examples
  • •Max nesting depth: 1

When to Use

This skill applies when:

  • •Constructing or validating uv commands
  • •Looking up flags, options, or subcommands
  • •Troubleshooting uv invocations or errors
  • •Needing correct syntax for uv operations

Prerequisites

Ensure uv is installed and available on PATH.

Quick Reference

CommandDescription
uv addAdd dependencies to the project
uv authManage authentication
uv buildBuild Python packages into source distributions and wheels
uv cacheManage uv's cache
uv exportExport the project's lockfile to an alternate format
uv formatFormat Python code in the project
uv helpDisplay documentation for a command
uv initCreate a new project
uv lockUpdate the project's lockfile
uv pipManage Python packages with a pip-compatible interface
uv publishUpload distributions to an index
uv pythonManage Python versions and installations
uv removeRemove dependencies from the project
uv runRun a command or script
uv selfManage the uv executable
uv syncUpdate the project's environment
uv toolRun and install commands provided by Python packages
uv treeDisplay the project's dependency tree
uv venvCreate a virtual environment
uv versionRead or update the project's version

Global Flags

FlagShortTypeDescription
--allow-insecure-host``stringAllow insecure connections to a host [env: UV_INSECURE_HOST=]
--cache-dir``stringPath to the cache directory [env: UV_CACHE_DIR=]
--color``stringControl the use of color in output [possible values: auto, always, never]
--config-file``stringThe path to a uv.toml file to use for configuration [env: UV_CONFIG_FILE=]
--directory``stringChange to the given directory prior to running the command [env: UV_WORKING_DIR=]
--help-hboolDisplay the concise help for this command
--managed-python``boolRequire use of uv-managed Python versions [env: UV_MANAGED_PYTHON=]
--native-tls``boolWhether to load TLS certificates from the platform's native store [env: UV_NATIVE_TLS=]
--no-cache-nstringAvoid reading from or writing to the cache, instead using a temporary directory for the
--no-config``stringAvoid discovering configuration files (pyproject.toml, uv.toml) [env: UV_NO_CONFIG=]
--no-managed-python``boolDisable use of uv-managed Python versions [env: UV_NO_MANAGED_PYTHON=]
--no-progress``boolHide all progress outputs [env: UV_NO_PROGRESS=]
--no-python-downloads``boolDisable automatic downloads of Python. [env: "UV_PYTHON_DOWNLOADS=never"]
--offline``boolDisable network access [env: UV_OFFLINE=]
--project``stringDiscover a project in the given directory [env: UV_PROJECT=]
--version-VboolDisplay the uv version

Command Overview

Commands

add, build, export, format, help, init, lock, publish, remove, run, sync, tree, venv, version

Command Groups

auth, cache, pip, python, self, tool

Common Usage Patterns

Detailed References

For complete command documentation including all flags and subcommands:

  • •Full command tree: see references/commands.md
  • •All usage examples: see references/examples.md

Troubleshooting

  • •Use uv --help or uv <command> --help for inline help
  • •Add --verbose for detailed output during debugging

Re-scanning

To update this plugin after a CLI version change, run the /scan-cli command or manually execute the crawler and generator.