How do I securely publish my package to PyPI?

The skill guides you through using 'build' to create distributions and 'twine' to securely upload them using API tokens or automated GitHub Actions.

Does it support complex projects like namespace packages?

Yes, it includes advanced patterns for creating namespace packages, which allow you to split large projects across multiple separate distributions.

Can I use this to create command-line tools?

Absolutely. The skill provides specific patterns for defining scripts and entry points in pyproject.toml using libraries like Click or argparse.

What is the recommended layout for a Python package?

The 'src' layout is highly recommended as it prevents accidental imports from the source directory and ensures your tests run against the installed version of the package.

Does this skill support modern PEP standards?

Yes, it focuses on PEP 517, 518, and 621, prioritizing the use of pyproject.toml as the single source of truth for metadata and build configuration.

Python Packaging & Distribution

Name: Python Packaging & Distribution
Author: carloscroc

bycarloscroc

0•

Developer Tools

Standardizes the creation of distributable Python packages using modern tools, pyproject.toml standards, and PyPI publishing best practices.

This skill provides comprehensive guidance for developers to build, structure, and distribute Python packages according to modern industry standards. It covers the implementation of PEP 517/518 and PEP 621 using pyproject.toml, helping users move away from legacy setup.py configurations toward more robust build backends like setuptools, hatchling, or flit. Whether you are building a simple CLI tool, a complex library with nested data files, or a multi-package namespace project, this skill ensures your project follows professional patterns for versioning, metadata management, and automated publishing via GitHub Actions.

Key Features

01Modern pyproject.toml configuration for metadata and dependencies

02Standardized project structure using source or flat layout patterns

030 GitHub stars

04Automated publishing workflows for PyPI and TestPyPI using Twine

05Command-line interface (CLI) registration via project entry points

06Advanced patterns for namespace packages and package data inclusion

Use Cases

01Publishing an open-source library to the Python Package Index (PyPI)

02Migrating legacy Python projects to modern packaging and build standards

03Distributing custom internal command-line tools for development teams

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add carloscroc/fitness python-packaging

For use in Claude.ai and ChatGPT

Download Skill