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

python-uv · oakoss — скилл для Claude Code: что делает и как установить

Скилл python-uv обучает ИИ-агента вести Python-проекты через uv: от uv init и управления зависимостями до рабочих пространств и сборки пакетов. Помогает отказаться от связки pip и poetry.

MIT 129 установок ★ 29 обновлён 2026-08-17

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

Что делает python-uv

Скилл задаёт агенту чёткие шаблоны для управления Python-проектами через менеджер uv. Вместо разрозненных вызовов pip, pyenv и poetry модель сразу применяет uv init, uv add и uv sync. Инструкции охватывают разметку pyproject.toml, фиксацию зависимостей в uv.lock и запуск изолированных инструментов через uvx.

Внутри собраны правила для монорепозиториев с общими воркспейсами, скриптов стандарта PEP 723 и публикации пакетов на PyPI. Агент перестаёт совершать частые промахи вроде ручной активации .venv или добавления виртуального окружения в git. Для научных сборок в Conda с системными C-библиотеками или старых проектов только на setup.py этот скилл не подойдёт из-за несовместимости с их структурой.

Какие задачи решает

  • инициализировать Python-проект или библиотеку с разметкой pyproject.toml
  • управлять зависимостями и фиксировать точные версии в uv.lock
  • настраивать запуск тестов в CI с проверкой актуальности замка через uv sync --locked
  • организовывать мультипакетные монорепозитории через секцию [tool.uv.workspace]

Примеры запросов агенту

  • Инициализируй новую библиотеку на Python через uv с поддержкой типов
  • Добавь pytest в dev-зависимости и обнови файл uv.lock
  • Настрой Dockerfile для запуска сервиса с установкой через uv sync --frozen

Как установить python-uv

1Через Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill python-uv -a claude-code

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

~/.claude/skills/python-uv/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о python-uv

Как установить python-uv в Claude Code?

Выполните в терминале команду npx skills add oakoss/agent-skills --skill python-uv -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/python-uv/SKILL.md.

Что делает скилл python-uv?

Он предоставляет агенту справочник команд uv, правила формирования файлов конфигурации и перечень типичных ошибок, предотвращая смешивание uv с pip.

В каких случаях этот скилл не подходит?

Его не стоит применять в проектах с научной средой Conda, требующей системных бинарных библиотек, а также в устаревших репозиториях только с setup.py.

Исходный текст

SKILL.md · MIT
---
name: python-uv
description: |
  Modern Python development with uv, the fast Python package and project manager. Covers project management (uv init, uv add, uv sync, uv lock), virtual environments, Python version management (uv python install/pin), script runners (uv run), tool management (uvx), workspace support for monorepos, and publishing to PyPI. Includes Python patterns for FastAPI, Pydantic, async/await, type checking, pytest, structlog, and CLI tools.

  Use when initializing Python projects, managing dependencies with uv, configuring pyproject.toml, setting up virtual environments, running scripts, managing Python versions, building monorepos with workspaces, containerizing Python apps, or writing modern Python with type hints.
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://docs.astral.sh/uv/'
user-invocable: false
---

# Python uv

## Overview

uv is an extremely fast Python package and project manager written in Rust, designed to replace pip, pip-tools, pipx, poetry, pyenv, and virtualenv. It provides unified project management, dependency resolution, Python version management, and tool execution with 10-100x speed improvements over traditional tools.

**Key capabilities:** Project initialization, dependency locking and syncing, Python version management, PEP 723 inline script dependencies, ephemeral tool execution via `uvx`, monorepo workspaces with shared lockfiles, and package building/publishing.

**When to use:** Python project initialization, dependency management, virtual environments, Python version pinning, running scripts with inline dependencies, monorepo workspaces, tool execution, publishing packages.

**When NOT to use:** Non-Python projects, conda-managed scientific computing environments with system-level binary dependencies, projects locked to legacy `setup.py`-only workflows.

## Quick Reference

| Pattern              | Command / API                         | Key Points                                     |
| -------------------- | ------------------------------------- | ---------------------------------------------- |
| Init project         | `uv init`                             | Creates `pyproject.toml` and `.python-version` |
| Init library         | `uv init --lib`                       | Creates `src/` layout with `py.typed`          |
| Init script          | `uv init --script example.py`         | PEP 723 inline metadata script                 |
| Add dependency       | `uv add requests`                     | Adds to `pyproject.toml`, updates lockfile     |
| Add dev dependency   | `uv add --dev pytest`                 | Adds to `[dependency-groups]` dev group        |
| Add group dependency | `uv add --group docs mkdocs`          | Custom dependency groups                       |
| Add optional         | `uv add --optional postgres psycopg`  | Optional extras for libraries                  |
| Remove dependency    | `uv remove requests`                  | Removes from `pyproject.toml` and lockfile     |
| Lock dependencies    | `uv lock`                             | Creates/updates `uv.lock`                      |
| Upgrade in lockfile  | `uv lock --upgrade-package requests`  | Targeted dependency upgrade                    |
| Sync environment     | `uv sync`                             | Installs locked dependencies into `.venv`      |
| Sync for CI          | `uv sync --locked`                    | Fails if lockfile is stale                     |
| Sync frozen          | `uv sync --frozen`                    | Skips lockfile verification                    |
| Run command          | `uv run python app.py`                | Runs in project virtual environment            |
| Run script           | `uv run script.py`                    | Supports PEP 723 inline dependencies           |
| Run in package       | `uv run --package api pytest`         | Workspace-specific execution                   |
| Install Python       | `uv python install 3.13`              | Downloads and manages Python versions          |
| Pin Python           | `uv python pin 3.12`                  | Writes `.python-version` file                  |
| List Pythons         | `uv python list`                      | Shows available and installed versions         |
| Run tool             | `uvx ruff check .`                    | Ephemeral tool execution                       |
| Tool with plugins    | `uvx --with mkdocs-material mkdocs`   | Ephemeral tool with extra packages             |
| Install tool         | `uv tool install ruff`                | Persistent global tool install                 |
| Workspace            | `[tool.uv.workspace]`                 | Monorepo multi-package support                 |
| Build package        | `uv build`                            | Creates sdist and wheel in `dist/`             |
| Publish              | `uv publish`                          | Uploads to PyPI with trusted publishing        |
| Export deps          | `uv export --format requirements-txt` | Generate requirements.txt from lockfile        |

## Common Mistakes

| Mistake                                     | Correct Pattern                                                          |
| ------------------------------------------- | ------------------------------------------------------------------------ |
| Using `pip install` inside uv project       | `uv add` to manage via `pyproject.toml`                                  |
| Activating venv manually before `uv run`    | `uv run` handles venv activation automatically                           |
| Committing `.venv/` to version control      | Add `.venv/` to `.gitignore`, commit `uv.lock`                           |
| Not committing `uv.lock`                    | Always commit `uv.lock` for reproducible builds                          |
| Using `uv sync` without `--locked` in CI    | `uv sync --locked` ensures lockfile matches `pyproject.toml`             |
| Running `uv lock --upgrade` routinely       | Only upgrade intentionally, use `--upgrade-package` for targeted updates |
| Mixing `pip` and `uv` dependency management | Choose one tool for the project consistently                             |
| Using `uv pip install` for project deps     | Use `uv add`/`uv sync` for managed projects                              |
| Forgetting `--frozen` for Docker builds     | `uv sync --frozen` skips lockfile verification for faster builds         |
| Creating venv manually in uv project        | `uv sync` creates and manages `.venv` automatically                      |
| Using `setup.py` for new projects           | Use `pyproject.toml` with a modern build backend                         |
| Not using `py.typed` in libraries           | `uv init --lib` includes it, required for typed packages                 |

## Delegation

- **Project scaffolding**: Use `Explore` agent
- **Dependency audit**: Use `Task` agent
- **Code review**: Delegate to `code-reviewer` agent

> If the `docker` skill is available, delegate containerization patterns to it.
> If the `github-actions` skill is available, delegate CI/CD pipeline configuration to it.
> If the `api-testing` skill is available, delegate API testing patterns to it.
> If the `sentry-setup-logging` skill is available, delegate error monitoring setup to it.
> If the `pino-logging` skill is available, delegate Node.js logging patterns to it (Python equivalent covered here with structlog).

## References

- [Project management and pyproject.toml configuration](references/project-management.md)
- [Dependency management, lockfiles, and groups](references/dependency-management.md)
- [Python version management and virtual environments](references/python-environments.md)
- [Scripts, inline dependencies, and tool management](references/scripts-and-tools.md)
- [Workspace support for monorepos](references/workspaces.md)
- [FastAPI web framework patterns](references/fastapi-patterns.md)
- [Pydantic validation and data modeling](references/pydantic-validation.md)
- [Async patterns with asyncio](references/async-patterns.md)
- [Type checking with mypy and pyright](references/type-checking.md)
- [Testing with pytest](references/testing-patterns.md)
- [Logging with structlog](references/structlog-logging.md)
- [CLI applications with typer](references/cli-applications.md)
- [Docker integration and publishing](references/docker-and-publishing.md)

© oakoss · MIT · oakoss/agent-skills

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

Все скиллы по теме «Языки программирования» →

Сначала — python-uv от других авторов.

python-uv Mindrally Скилл python-uv для Claude Code. Заставляет агента ставить и синхронизировать Python-пакеты только через uv, без pip и poetry. В проекте с uv или когда нужна стабильность окружений. CX Codex +1 1 000установок setup-python-env reflex-dev Скилл setup-python-env для Claude Code, Codex, Cursor и других платформ: создаёт виртуальное окружение Python и ставит Reflex. Запускается при старте нового проекта или когда агент видит отсутствие .venv. CX Codex +1 794установок python-pro Seth Hobson Субагент python-pro для Claude Code пишет и разбирает код на Python 3.12+, включая async, тесты, API и производительность. Помогает разрабатывать и рефакторить Python-проекты. CX Codex 11 689установок python-scaffold Seth Hobson Команда python-scaffold для Claude Code создаёт каркас Python-проекта под FastAPI, Django, библиотеку или CLI. По запросу она формирует структуру каталогов, настройки и тесты. CX Codex +1 ★ 42 780звёзд репо uv astral-sh Обучает агента управлять окружением и зависимостями через менеджер uv. Перехватывает задачи по скриптам, пакетам и проектам на Python. CX Codex +1 5 300установок python-pypi-package-builder официальный github Скилл python-pypi-package-builder для GitHub Copilot собирает и проверяет Python-пакет, настраивает его версию и публикует в PyPI. Работает с библиотеками, SDK, CLI и плагинами. CX Codex +1 943установок modern-python trailofbits Скилл modern-python для Claude Code настраивает Python-проекты с uv, ruff и ty; применяется при создании проектов, написании скриптов и миграции со старых инструментов. CX Codex +1 9 700установок

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

Весь набор →
mise Обучает агента работать с mise — менеджером версий инструментов, переменных окружения и задач. CX Codex +1 133установок data-visualizer Скилл data-visualizer помогает строить графики и дашборды на Recharts, Chart.js или D3.js с учётом адаптивности и доступности. CX Codex +1 133установок knowledge-base-manager Скилл knowledge-base-manager для Claude Code помогает выбрать архитектуру базы знаний и выстроить её поддержку. Охватывает отбор контента, контроль качества и версионирование. CX Codex +1 131установок secure-ai Скилл secure-ai для защиты LLM-слоя приложения: инъекции в промпт, проверка вывода модели, zero-trust для агентов с инструментами. CX Codex +1 130установок rust Скилл подсказывает паттерны Rust для ownership, async-кода, веб-сервисов, CLI и тестов. Пригодится при разработке и ревью Rust-проектов. CX Codex +1 128установок github-cli Скилл github-cli обучает ИИ-агента шаблонам работы с утилитой gh: создание PR, разбор задач, запуск экшенов и запросы к GraphQL API прямо в терминале. CX Codex +1 128установок resend Помогает агенту настроить отправку писем через Resend API, шаблоны React Email, верификацию доменов и вебхуки Svix. CX Codex +1 127установок tanstack-pacer Даёт агенту карту TanStack Pacer: дебаунс, троттлинг, лимиты, очереди и React-хуки. Ограничивает частоту срабатывания обработчиков и запросов. CX Codex +1 126установок

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

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