Agent skill
python-packaging-uv
Use when building or publishing Python packages with uv, including dist artifacts and pre-publish checks.
Install this agent skill to your Project
npx add-skill https://github.com/narumiruna/agent-skills/tree/main/skills/python-packaging-uv
SKILL.md
Python Packaging with uv
Overview
Use uv build and publish commands to produce wheels/sdists and ship to PyPI. Core principle: build, verify, then publish.
Quick Reference
| Task | Command |
|---|---|
| Build wheel+sdist | uv build |
| Build wheel only | uv build --no-sources |
| Publish to PyPI | uv publish --token $PYPI_TOKEN |
| Publish to Test PyPI | uv publish --publish-url https://test.pypi.org/legacy/ --token $TEST_PYPI_TOKEN |
Workflow
- Build artifacts in
dist/. - Test install from wheel.
- Publish to Test PyPI, validate, then publish to PyPI.
Example
uv build --no-sources
uv pip install dist/my_package-1.0.0-py3-none-any.whl
uv publish --publish-url https://test.pypi.org/legacy/ --token $TEST_PYPI_TOKEN
Common Mistakes
- Publishing before verifying wheel contents.
- Skipping Test PyPI for first release.
Red Flags
- Packaging guidance that ignores uv build/publish.
References
references/packaging.md- Build and publish details
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
slide-creator
Use when creating slide decks with Marp/Marpit Markdown (marp), including authoring slide content, designing slide color schemes, and building SVG diagrams or illustrations for the deck.
slide-color-design
Use when you only need slide color systems, palette selection, or palette generation workflows and want direct pointers to the color design references.
mermaid-creator
Use when creating or converting Mermaid diagrams (for example flowcharts, sequence diagrams, ER diagrams, and Gantt charts), including exporting to SVG for docs or slides.
test-driven-development
Use when implementing non-trivial code changes that should follow TDD (write a failing test first, make the smallest passing change, then refactor safely).
svg-illustration
Use when you need SVG diagram rules, layout patterns, or embedding guidance for slide decks and want the minimal SVG-focused reading path.
python-cli-typer
Use when building or structuring Python CLI commands with Typer, including commands, options, and multi-command apps.
Didn't find tool you were looking for?