К основному содержанию
скилл CX Codex

uv-tool-management — скилл для Claude Code: управление CLI

Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest.

MIT 328 установок ★ 60 обновлён 2026-11-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add laurigates/claude-plugins --skill uv-tool-management -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/uv-tool-management/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/uv-tool-management/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Языки программирования» →
uv astral-sh Обучает агента управлять окружением и зависимостями через менеджер uv. Перехватывает задачи по скриптам, пакетам и проектам на Python. CX Codex +1 5 300установок aicore-lifecycle-management SAP Скилл aicore-lifecycle-management для Claude Code управляет жизненным циклом ресурсов в SAP AI Core. Запускает сценарии, создаёт конфигурации, развёртывает модели и читает логи инференса. CX Codex +1 251установок writing-python julianobarbosa Скилл writing-python держит агента в правилах Python 3.14+: сначала стандартная библиотека, аннотации типов у всех функций, uv и ruff вместо pip и black. CX Codex +1 134установок jira-communication Netresearch DTT GmbH Скилл jira-communication управляет задачами Jira через CLI-скрипты: ищет тикеты, меняет поля и статусы, добавляет комментарии и трудозатраты. Сработает и на запрос о Jira без ключа тикета. CX Codex +1 588установок python-scaffold Seth Hobson Команда python-scaffold для Claude Code создаёт каркас Python-проекта под FastAPI, Django, библиотеку или CLI. По запросу она формирует структуру каталогов, настройки и тесты. CX Codex +1 ★ 42 780звёзд репо python-script microsoft Правило python-script задаёт стандарты написания утилит автоматизации на Python 3.11+ для Claude Code: управление пакетами через uv, строгие типы и единая структура CLI. CX Codex +1 ★ 1 627звёзд репо

Из того же набора27

Весь набор →
uv-run Скилл uv-run инструктирует агента запускать Python-скрипты через менеджер uv без ручной активации виртуального окружения и оформлять зависимости прямо внутри файла. CX Codex +1 342установок python-packaging Скилл python-packaging помогает собрать пакеты wheel и sdist через uv, а затем выгрузить их в PyPI или Test PyPI. Пригодится при настройке pyproject.toml и консольных утилит. CX Codex +1 336установок uv-python-versions Скилл uv-python-versions помогает управлять версиями CPython и PyPy через uv: устанавливать интерпретаторы, закреплять версию проекта и переключаться между ними. CX Codex +1 332установок uv-advanced-dependencies Скилл uv-advanced-dependencies для работы с нестандартными источниками зависимостей в uv: репозиториями на GitHub, локальными пакетами в режиме редактирования, приватными индексами. CX Codex +1 332установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок jq-json-processing Скилл jq-json-processing для парсинга, фильтрации и трансформации JSON через jq. Извлекает поля, фильтрует массивы, перестраивает объекты и валидирует синтаксис. CX Codex +1 245установок python-development Скилл python-development даёт агенту идиомы Python 3.10+: подсказки типов, match, asyncio, отладку. Полезен, когда правите библиотечный код или разбираете чужой. CX Codex +1 192установок generate-image Скилл generate-image генерирует изображения из текстового описания через модель Gemini 3 Pro Image, работает на Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 177установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой