What is the recommended Python project layout?

This skill recommends the 'src' layout, which places source code in a dedicated src/ directory to prevent accidental imports from the root and ensure a more robust testing environment.

Does this skill support modern PEP packaging standards?

Yes, it fully supports PEP 517, 518, 621, and 660, prioritizing the use of pyproject.toml as the single source of truth for project configuration.

Can I use this skill to create command-line tools?

Absolutely. The skill provides specific patterns for registering CLI entry points using popular libraries like Click or the standard argparse module.

Can it help automate my release process?

Yes, it includes advanced patterns for GitHub Actions that automate the entire build, check, and publish cycle whenever a new release is created.

How does it handle publishing to the Python Package Index (PyPI)?

It provides guided workflows for building wheels and source distributions, as well as using Twine for secure uploads to both TestPyPI and production PyPI.

Python Packaging & Distribution

Name: Python Packaging & Distribution
Author: kivilaid

bykivilaid

•

Developer Tools

Streamlines the creation, configuration, and distribution of production-ready Python packages using modern PEP standards.

About

This skill provides comprehensive guidance for developers looking to transform Python code into professional, installable libraries or CLI tools. It automates the setup of standardized project structures—including the recommended source layout—and handles the complexities of modern pyproject.toml configurations, dependency management, and build backends like setuptools. Whether you are publishing a library to PyPI or building a private internal utility, this skill ensures your packages follow current best practices for versioning, metadata, and automated distribution workflows via GitHub Actions.

Key Features

Automated build and publishing workflows for PyPI, TestPyPI, and private registries
6 GitHub stars
Advanced patterns for namespace packages, dynamic versioning, and data file inclusion
Standardized project structure generation including recommended source layouts
Comprehensive pyproject.toml configuration following PEP 621 metadata standards
CLI tool integration with pre-configured Click and argparse entry points

Use Cases

Building and registering command-line interfaces for terminal-based internal tools
Implementing CI/CD pipelines with GitHub Actions for automated package releases and versioning
Converting a collection of utility scripts into a professional, distributable Python library

About

Key Features

Automated build and publishing workflows for PyPI, TestPyPI, and private registries
6 GitHub stars
Advanced patterns for namespace packages, dynamic versioning, and data file inclusion
Standardized project structure generation including recommended source layouts
Comprehensive pyproject.toml configuration following PEP 621 metadata standards
CLI tool integration with pre-configured Click and argparse entry points

Use Cases

Building and registering command-line interfaces for terminal-based internal tools
Implementing CI/CD pipelines with GitHub Actions for automated package releases and versioning
Converting a collection of utility scripts into a professional, distributable Python library