python-packaging · laurigates — скилл для Claude Code: что делает и как установить
Скилл python-packaging помогает собрать пакеты wheel и sdist через uv, а затем выгрузить их в PyPI или Test PyPI. Пригодится при настройке pyproject.toml и консольных утилит.
MIT 336 установок ★ 60 обновлён 2026-11-16
npx skills add laurigates/claude-plugins --skill python-packaging -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/python-packaging/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/python-packaging/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-packaging -a codex2Вручную: положить файлы
.agents/skills/python-packaging/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-packaging -a cursor2Вручную: положить файлы
.cursor/skills/python-packaging/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install laurigates/claude-plugins python-plugin/skills/python-packaging2Вручную: положить файлы
.github/skills/python-packaging/SKILL.md1Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-packaging -a gemini-cli2Командой платформы
gemini skills install https://github.com/laurigates/claude-plugins --path python-plugin/skills/python-packagingВручную: положить файлы
.devin/skills/python-packaging/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add laurigates/claude-plugins --skill python-packaging -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.