python-packaging

Create Python packages with .deb-like simplicity.

6|2|Updated Jan 6, 2026
One-click install
npx skills add https://github.com/acaprino/alfio-claude-plugins --skill python-packaging-acaprino
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-packaging
Source: https://github.com/acaprino/alfio-claude-plugins/tree/main/plugins/python-development/skills/python-packaging
Command: npx skills add https://github.com/acaprino/alfio-claude-plugins --skill python-packaging-acaprino

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps developers create, structure, and publish Python packages using modern packaging tools, pyproject.toml, and distribution to PyPI or private registries.

Core Features & Use Cases

  • Modern packaging setup: guide to pyproject.toml, build backends, and packaging metadata.
  • Project layout patterns: source and flat layouts, tests, and documentation integration.
  • Publishing workflow: build wheel and source distributions, and publish to PyPI or private repositories.
  • Use Case: Package a library for distribution with CLI entry points and proper metadata.

Quick Start

Scaffold a minimal Python package named example-package with pyproject.toml, a src/example_package, and a simple README, then build and publish to TestPyPI.

Frequently Asked Questions about python-packaging

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up pyproject.toml for publishing a Python package?

Configure pyproject.toml by defining project metadata, classifiers, build backends, and entry points. This provides a modern, standardized configuration for building and publishing Python packages to PyPI or private registries.

What is the best way to build wheel and source distributions for PyPI?

The best way to build wheel and source distributions is using modern Python packaging tools configured via pyproject.toml. This generates reliable distribution artifacts ready for upload to PyPI or private repositories.

How do I structure a Python project using a src layout for distribution?

Structure a Python project using a src layout by placing package code inside a src directory, alongside pyproject.toml and a README. This pattern ensures clean imports and reliable packaging metadata enforcement.

How do I add CLI entry points and proper metadata to a Python library?

Add CLI entry points and metadata directly within pyproject.toml. This configures executable command interfaces and enforces packaging metadata requirements, ensuring your library is ready for reliable distribution and adoption.

Can I publish a Python package to a private registry instead of PyPI?

Yes, you can publish Python packages to private registries instead of PyPI. The packaging workflow builds wheel and source distributions locally, which can then be uploaded to your configured private repository endpoint.