uv-tool-management — скилл для Claude Code: управление CLI
Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest.
MIT 328 установок ★ 60 обновлён 2026-11-16
npx skills add laurigates/claude-plugins --skill uv-tool-management -a claude-codeЧто делает uv-tool-management
Скилл подсказывает, как устанавливать инструменты через uv tool install, запускать разово с помощью uvx, просматривать список, обновлять и удалять утилиты. Он также объясняет, как закрепить версию или установить пакет из Git-репозитория. Например, uvx ruff check . запускает проверку без постоянной установки ruff.
У каждой установленной утилиты отдельное виртуальное окружение, поэтому зависимости инструментов изолированы друг от друга. Бинарные файлы должны быть доступны через PATH: если каталог с ними туда не добавлен, команды вроде ruff не запустятся напрямую. Для зависимостей конкретного проекта скилл отделяет uv add от глобального uv tool install.
Какие задачи решает
- установить Python CLI-утилиту для разных проектов
- запустить инструмент разово без установки
- посмотреть список глобальных инструментов и обновить нужный
- удалить одну утилиту или все установленные инструменты
- закрепить версию CLI-инструмента или установить его из Git
Примеры запросов агенту
- Установи
ruffкак глобальную CLI-утилиту черезuv. - Запусти
black --check .разово, не устанавливая его постоянно. - Покажи установленные через
uvинструменты и обновиpytest.
Как установить uv-tool-management
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-tool-management -a claude-code2Вручную: положить файлы
~/.claude/skills/uv-tool-management/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/uv-tool-management/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-tool-management -a codex2Вручную: положить файлы
.agents/skills/uv-tool-management/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-tool-management -a cursor2Вручную: положить файлы
.cursor/skills/uv-tool-management/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install laurigates/claude-plugins python-plugin/skills/uv-tool-management2Вручную: положить файлы
.github/skills/uv-tool-management/SKILL.md1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-tool-management -a gemini-cli2Командой платформы
gemini skills install https://github.com/laurigates/claude-plugins --path python-plugin/skills/uv-tool-managementВручную: положить файлы
.devin/skills/uv-tool-management/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill uv-tool-management -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об uv-tool-management
Как установить uv-tool-management в Claude Code?
Выполните npx skills add laurigates/claude-plugins --skill uv-tool-management -a claude-code. Файл скилла находится по пути ~/.claude/skills/uv-tool-management/SKILL.md.
Что делает uv-tool-management?
Он помогает управлять глобальными Python CLI-утилитами через uv: устанавливать, обновлять, удалять и запускать без установки с помощью uvx.
Чем uv tool отличается от uv add?
uv tool install предназначен для CLI-инструментов, доступных в разных проектах. uv add добавляет зависимость в конкретный проект.
Исходный текст
SKILL.md · MIT
--- created: 2025-12-16 modified: 2026-11-14 reviewed: 2026-04-25 name: uv-tool-management description: Install and manage global Python CLI tools with uv (pipx alternative). Use when the user mentions uv tool, uvx, installing CLI tools globally, or pipx replacement. user-invocable: false allowed-tools: Bash(uv tool install *), Bash(uv tool list *), Bash(uv tool upgrade *), Bash(uv tool uninstall *), Bash(uvx ruff *), Bash(uvx black *), Read, Grep, Glob --- # UV Tool Management Quick reference for installing and managing global Python tools with UV (pipx alternative). ## When to Use This Skill | Use this skill when... | Use a focused sibling instead when... | |---|---| | Installing a global CLI tool (ruff, black, ipython) with `uv tool install` as a pipx replacement | Running a project script inside its venv — use uv-run | | Running a one-off CLI invocation via `uvx tool` without installing | Adding the tool as a project dev dependency — use uv-project-management | | Listing, upgrading, or uninstalling globally installed tools | Pinning the Python version a tool runs on — use uv-python-versions | ## When This Skill Applies - Installing command-line tools globally (like pipx) - Managing tool installations and updates - Running tools ephemerally without installation - Listing and removing installed tools - Tool version management ## Quick Reference ### Installing Tools ```bash # Install tool globally uv tool install ruff uv tool install black uv tool install pytest # Install specific version uv tool install [email protected] uv tool install 'pytest>=7.0' # Install from Git uv tool install git+https://github.com/astral-sh/ruff # Install with extras uv tool install 'mkdocs[i18n]' uv tool install 'fastapi[all]' ``` ### Running Tools ```bash # Run without installing (ephemeral) uvx pycowsay "hello world" uvx ruff check . uvx black --check . # uvx is alias for: uv tool run pycowsay "hello world" # Run with specific version uvx [email protected] check . # Run from Git uvx git+https://github.com/user/tool script.py ``` ### Managing Tools ```bash # List installed tools uv tool list # Update tool uv tool install ruff --reinstall uv tool upgrade ruff # Remove tool uv tool uninstall ruff # Remove all tools uv tool uninstall --all ``` ### Tool Information ```bash # Check tool version ruff --version # List tool binaries uv tool list --verbose # Show tool location which ruff # ~/.local/bin/ruff (Linux) # ~/Library/Application Support/uv/bin/ruff (macOS) ``` ## uvx vs uv tool run These commands are equivalent: ```bash uvx ruff check . uv tool run ruff check . ``` `uvx` is a convenient shorthand for ephemeral tool execution. ## Installation Locations ### Tools Directory ```bash # Linux ~/.local/share/uv/tools/ # macOS ~/Library/Application Support/uv/tools/ # Windows %LOCALAPPDATA%\uv\tools\ ``` ### Binaries (Executables) ```bash # Linux ~/.local/bin/ # macOS ~/Library/Application Support/uv/bin/ # Windows %LOCALAPPDATA%\uv\bin\ ``` **Add to PATH:** ```bash # Add to ~/.bashrc or ~/.zshrc export PATH="$HOME/.local/bin:$PATH" ``` ## Common Tools ```bash # Code quality uv tool install ruff uv tool install black uv tool install ty # Documentation uv tool install mkdocs uv tool install sphinx # Testing uv tool install pytest uv tool install tox # Build tools uv tool install build uv tool install twine # Utilities uv tool install httpie uv tool install pipx uv tool install cookiecutter ``` ## UV Tool vs Project Dependencies **Use `uv tool` for:** - Command-line applications - Global development tools - Utilities used across projects **Use `uv add` for:** - Project-specific dependencies - Libraries imported in code - Development dependencies in specific projects ```bash # Global tool (any project) uv tool install ruff # Project dependency (one project) uv add --dev ruff ``` ## Tool Isolation Each tool gets its own virtual environment: ```bash # Each tool is isolated ~/.local/share/uv/tools/ ├── ruff/ # Isolated environment for ruff ├── black/ # Isolated environment for black └── pytest/ # Isolated environment for pytest # No dependency conflicts between tools ``` ## Common Workflows ### Setup Development Tools ```bash # Install common development tools globally uv tool install ruff uv tool install ty uv tool install pytest uv tool install ipython # Now available in any project ruff check . ty check src/ pytest ipython ``` ### One-Off Tool Usage ```bash # Run without installing uvx pycowsay "Temporary tool!" uvx httpie https://api.github.com # No cleanup needed ``` ### Replace pipx ```bash # Old (pipx) pipx install black pipx run pycowsay "hello" # New (uv) uv tool install black uvx pycowsay "hello" ``` ## Key Features - **Fast**: 10-100x faster than pipx - **Isolated**: Each tool in separate environment - **Ephemeral**: Run tools without installation - **Version control**: Pin tool versions - **Git support**: Install from repositories ## See Also - `uv-project-management` - Project-specific dependencies - `uv-python-versions` - Python versions for tools - `python-code-quality` - Using ruff, ty, black ## References - Official docs: https://docs.astral.sh/uv/guides/tools/ - Tool directory: Use `uv cache dir` to find cache location - Detailed guide: See REFERENCE.md in this skill directory
© laurigates · MIT · laurigates/claude-plugins