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

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

Скилл python-packaging помогает собрать пакеты wheel и sdist через uv, а затем выгрузить их в PyPI или Test PyPI. Пригодится при настройке pyproject.toml и консольных утилит.

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

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

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

Скилл даёт ассистенту готовые сценарии для сборки Python-пакетов с помощью инструмента Astral uv. Он охватывает запуск uv build, разделение форматов wheel и sdist с выводом файлов в папку dist/, а также отправку релизов в репозитории через uv publish.

Внутри описана структура pyproject.toml: заполнение метаданных, классификаторов PyPI, консольных скриптов в блоке [project.scripts] и динамических версий из git-тегов. Поддерживаются сборочные бэкенды uv_build, hatchling и setuptools. Для публикации на PyPI заранее потребуется токен доступа в переменной окружения $PYPI_TOKEN.

Этот скилл отвечает исключительно за сборку и дистрибуцию. Зависимости и файл блокировки lockfile настраиваются отдельно.

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

  • собрать пакеты wheel и sdist в каталог dist/ командой uv build
  • опубликовать релиз в PyPI или Test PyPI с авторизацией по токену
  • прописать консольные скрипты и точки входа в pyproject.toml
  • настроить динамическое версионирование пакета на основе git-тегов

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

  • Собери wheel и sdist для моего проекта через uv
  • Настрой в pyproject.toml консольную команду cli и подготовь сборку
  • Опубликуй готовый релиз из каталога dist в Test PyPI

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

1Через Skills CLI (Vercel)

npx skills add laurigates/claude-plugins --skill python-packaging -a claude-code

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

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

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

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

Вопросы о python-packaging

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

Выполните команду npx skills add laurigates/claude-plugins --skill python-packaging -a claude-code. Файл скилла будет доступен по пути ~/.claude/skills/python-packaging/SKILL.md.

Чем python-packaging отличается от uv-project-management?

Скилл python-packaging сфокусирован на подготовке артефактов, метаданных и публикации в PyPI. Управление виртуальным окружением, lock-файлом и зависимостями вынесено в скилл uv-project-management.

Какие сборочные бэкенды поддерживает скилл?

Инструкции содержат примеры для штатного uv_build, а также для setuptools и hatchling.

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

SKILL.md · MIT
---
created: 2025-12-16
modified: 2026-11-14
reviewed: 2026-04-25
name: python-packaging
description: Build and publish Python packages with uv. Use when the user mentions building packages, publishing to PyPI, wheel/sdist creation, or entry points.
user-invocable: false
allowed-tools: Bash(uv build *), Bash(uv publish *), Read, Grep, Glob
---

# Python Packaging

Quick reference for building and publishing Python packages with UV and modern build tools.

## When to Use This Skill

| Use this skill when... | Use uv-project-management instead when... |
|---|---|
| Building a wheel/sdist with `uv build` for PyPI distribution | Setting up a new project's pyproject.toml or adding runtime dependencies |
| Publishing a release to PyPI or a private index with `uv publish` | Managing the lockfile or syncing the local virtual environment |
| Configuring entry points, console scripts, or package metadata for distribution | Resolving dependency conflicts or pinning versions for development |

## When This Skill Applies

- Building Python packages (wheels, sdists)
- Publishing to PyPI or private indexes
- Package versioning
- Build system configuration
- Editable installations

## Quick Reference

### Building Packages

```bash
# Build package
uv build

# Build specific formats
uv build --wheel
uv build --sdist

# Output location: dist/
```

### Publishing

```bash
# Publish to PyPI
uv publish

# With token
uv publish --token $PYPI_TOKEN

# To Test PyPI
uv publish --publish-url https://test.pypi.org/legacy/
```

### Package Structure

```
my-package/
├── pyproject.toml
├── README.md
├── LICENSE
├── src/
│   └── my_package/
│       ├── __init__.py
│       ├── __version__.py
│       └── main.py
└── tests/
```

## pyproject.toml Configuration

```toml
[project]
name = "my-package"
version = "0.1.0"
description = "A great package"
readme = "README.md"
requires-python = ">=3.11"
license = {text = "MIT"}
authors = [
    {name = "Your Name", email = "[email protected]"}
]
keywords = ["python", "package"]
classifiers = [
    "Development Status :: 4 - Beta",
    "Intended Audience :: Developers",
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
]

dependencies = [
    "requests>=2.31.0",
]

[project.optional-dependencies]
dev = ["pytest", "ruff", "ty"]

[project.urls]
Homepage = "https://github.com/user/my-package"
Documentation = "https://my-package.readthedocs.io"
Repository = "https://github.com/user/my-package.git"
Issues = "https://github.com/user/my-package/issues"

[project.scripts]
my-cli = "my_package.cli:main"

[build-system]
requires = ["uv_build>=0.9.2,<0.10.0"]
build-backend = "uv_build"
```

## Versioning

```toml
[project]
version = "0.1.0"  # Manual versioning

# Dynamic versioning (from git tags)
dynamic = ["version"]

[tool.uv]
version-provider = "git"
```

## Entry Points

```toml
[project.scripts]
my-cli = "my_package.cli:main"

[project.gui-scripts]
my-gui = "my_package.gui:main"

[project.entry-points."my_plugin"]
plugin1 = "my_package.plugins:plugin1"
```

## Build Backends

### UV Build (default)

```toml
[build-system]
requires = ["uv_build>=0.9.2,<0.10.0"]
build-backend = "uv_build"
```

### Setuptools

```toml
[build-system]
requires = ["setuptools>=68", "wheel"]
build-backend = "setuptools.build_meta"
```

### Hatchling

```toml
[build-system]
requires = ["hatchling>=1.18"]
build-backend = "hatchling.build"
```

## Common Workflows

### Publish to PyPI

```bash
# 1. Build
uv build

# 2. Check built packages
ls dist/

# 3. Publish
uv publish --token $PYPI_TOKEN
```

### Test PyPI First

```bash
# Publish to Test PyPI
uv publish --publish-url https://test.pypi.org/legacy/ \
           --token $TEST_PYPI_TOKEN

# Test installation
pip install --index-url https://test.pypi.org/simple/ my-package
```

## Package Classifiers

Common classifiers:

```toml
classifiers = [
    # Development Status
    "Development Status :: 3 - Alpha",
    "Development Status :: 4 - Beta",
    "Development Status :: 5 - Production/Stable",

    # Audience
    "Intended Audience :: Developers",
    "Intended Audience :: Science/Research",

    # License
    "License :: OSI Approved :: MIT License",

    # Python Versions
    "Programming Language :: Python :: 3",
    "Programming Language :: Python :: 3.11",
    "Programming Language :: Python :: 3.12",

    # Framework
    "Framework :: Django",
    "Framework :: FastAPI",

    # Topic
    "Topic :: Software Development :: Libraries",
    "Topic :: Scientific/Engineering",
]
```

Full list: https://pypi.org/classifiers/

## See Also

- `uv-project-management` - Project setup and dependencies
- `python-development` - Core Python patterns
- `uv-workspaces` - Building workspace packages

## References

- UV build: https://docs.astral.sh/uv/guides/publish/
- PyPI: https://pypi.org/
- Detailed guide: See REFERENCE.md

© laurigates · MIT · laurigates/claude-plugins

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

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

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

python-packaging Seth Hobson Скилл python-packaging помогает собрать Python-библиотеку или CLI-инструмент в устанавливаемый пакет и подготовить публикацию в PyPI. Подходит для настройки структуры проекта. CX Codex +1 12 915установок Python Packaging taste f Промпт Python Packaging taste для ChatGPT и Claude.ai, который задаёт агенту правила упаковки Python-проектов: pyproject.toml, src/, uv, Ruff. Направляет модель давать советы по одному стилю вместо разных подходов. GP ChatGPT ★ 178 201звёзд репо Poetry Packaging pluginagentmarketplace Скилл Poetry Packaging обучает агента собирать пакеты Python через Poetry, настраивать pyproject.toml и публиковать релизы в PyPI. CX Codex +1 132установок python-pypi-package-builder официальный github Скилл python-pypi-package-builder для GitHub Copilot собирает и проверяет Python-пакет, настраивает его версию и публикует в PyPI. Работает с библиотеками, SDK, CLI и плагинами. CX Codex +1 943установок uv harperreed Помогает настроить Python-проекты через uv: зависимости, виртуальные окружения, скрипты PEP 723, CI и сборку Docker. CX Codex +1 ★ 339звёзд репо pypi-doppler terrylica Скилл pypi-doppler для Claude Code и пяти других платформ: публикует Python-пакет в PyPI с токеном из Doppler — только с локальной машины. CI/CD намеренно заблокирован: скрипт проверяет окружение и останавливается при обнаружении пайплайна. CX Codex +1 123установок python-uv Mindrally Скилл python-uv для Claude Code. Заставляет агента ставить и синхронизировать Python-пакеты только через uv, без pip и poetry. В проекте с uv или когда нужна стабильность окружений. CX Codex +1 1 000установок

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

Весь набор →
uv-project-management Скилл uv-project-management для Claude Code помогает создавать Python-проекты и управлять зависимостями через uv. Подключается при работе с pyproject.toml, lock-файлами и командами uv init, uv add или uv sync. CX Codex +1 358установок basedpyright-type-checking Скилл basedpyright-type-checking настраивает статическую типизацию Python через basedpyright, помогает выбрать между ним и mypy, а также подготовить конфигурацию для проекта. CX Codex +1 357установок uv-workspaces Скилл uv-workspaces для работы с многопакетными Python-проектами на uv: настройка workspace, общий lockfile, зависимости между пакетами. CX Codex +1 356установок uv-run Скилл uv-run инструктирует агента запускать Python-скрипты через менеджер uv без ручной активации виртуального окружения и оформлять зависимости прямо внутри файла. CX Codex +1 342установок 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установок uv-tool-management Скилл uv-tool-management для Claude Code управляет глобальными Python CLI-утилитами через uv и запускает их без установки. Заменяет pipx и работает с ruff и pytest. CX Codex +1 328установок imagemagick-conversion Скилл imagemagick-conversion для Claude Code пакетно преобразует, масштабирует и оптимизирует изображения через ImageMagick в командной строке. Конвертирует форматы, создаёт миниатюры и обрабатывает сотни файлов за раз. CX Codex +1 260установок

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

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