# Poetry Packaging

Poetry Packaging guides your coding agent through Python package setups, pyproject.toml dependency constraints, and PyPI publishing.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 132 installs · ★ 7 repo stars
- Author: pluginagentmarketplace
- License: LicenseRef-Proprietary · policy=link-only · description only; the file stays with the author
- Source: https://github.com/pluginagentmarketplace/custom-plugin-python/tree/HEAD/skills/poetry-packaging/SKILL.md
- Updated: 2026-01-05
- Security check: automated, 2026-11-16 (text) — warning: a command downloads a script from install.python-poetry.org and runs it right away. Do not run such commands without an explicit yes from the human.
- HTML: https://affpapa.org/en/nevibecode/skills/poetry-packaging

## What it does

This skill teaches your assistant how to structure Python packages and manage isolated environments using Poetry. It covers creating directory layouts with `py.typed` markers, organizing tests, and splitting dependencies into designated groups for linting or testing.

It details semantic version increments, building sdist and wheel distributions, and uploading packages to TestPyPI or PyPI. To execute these workflows locally, Poetry must already be installed on your system.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill poetry-packaging -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/poetry-packaging/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/poetry-packaging/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill poetry-packaging -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/poetry-packaging/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill poetry-packaging -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/poetry-packaging/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install pluginagentmarketplace/custom-plugin-python skills/poetry-packaging
```

2. **Manually: put the files in place**
- File: `.github/skills/poetry-packaging/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill poetry-packaging -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/pluginagentmarketplace/custom-plugin-python --path skills/poetry-packaging
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/poetry-packaging/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add pluginagentmarketplace/custom-plugin-python --skill poetry-packaging -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/pluginagentmarketplace/custom-plugin-python/tree/HEAD/skills/poetry-packaging/SKILL.md

## When to use it
- configure pyproject.toml metadata and command-line entry points
- scaffold standardized directory trees for Python packages
- build sdist and wheel distribution archives
- handle package publishing workflows targeting PyPI or TestPyPI

## Example prompts
- Create a pyproject.toml file for a CLI tool with requests and click dependencies
- Show the steps to bump the package version and publish it to TestPyPI
- Export project dependencies from poetry.lock into requirements.txt

## Similar
- [python-packaging](https://affpapa.org/en/nevibecode/skills/python-packaging.md) — skill · 12915 installs
- [poetry](https://affpapa.org/en/nevibecode/rules/poetry.md) — rule · ★ 3589 repo stars
- [uv-advanced-dependencies](https://affpapa.org/en/nevibecode/skills/uv-advanced-dependencies.md) — skill · 332 installs
- [python-pypi-package-builder](https://affpapa.org/en/nevibecode/skills/python-pypi-package-builder.md) — skill · 943 installs
- [Python Packaging taste](https://affpapa.org/en/nevibecode/prompts/python-packaging-taste.md) — prompt · ★ 178201 repo stars
- [suede-launch-packaging](https://affpapa.org/en/nevibecode/skills/suede-launch-packaging.md) — skill · ★ 121 repo stars

From the same set: [pluginagentmarketplace/custom-plugin-python](https://affpapa.org/en/nevibecode/by/pluginagentmarketplace/custom-plugin-python.md) — 12 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
