Why does this skill recommend the src/ layout?

The src/ layout is a best practice that ensures tests run against the installed package rather than the local source directory, which helps catch packaging and import errors early in development.

How does it handle Python type hinting for library users?

It ensures the inclusion of the 'py.typed' marker file (PEP 561), which informs type checkers like mypy and Pyright that your package provides inline type hints.

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

Yes, it includes specific patterns for defining [project.scripts] in your configuration and structuring your package to support seamless CLI entry points.

Does this skill support legacy setup.py files?

While it can recognize them, the skill identifies setup.py as a legacy anti-pattern and provides automated patterns to migrate your configuration to the modern pyproject.toml standard.

Python Packaging Standards

Name: Python Packaging Standards
Author: ricardoroche

byricardoroche

0•

Developer Tools

Standardizes Python project configuration and distribution using modern pyproject.toml patterns and professional project structures.

This skill provides comprehensive guidance for modern Python packaging, moving beyond legacy setup.py files to robust pyproject.toml configurations. It ensures projects follow the 'src' layout convention, include proper type hint markers (PEP 561), manage dependencies with precise version pinning, and implement professional CLI entry points. Whether you are building a library for PyPI or an internal tool, this skill automates the setup of build systems, metadata, and distribution workflows including automated GitHub Actions for publishing.

Key Features

01Modern pyproject.toml configuration compliant with latest PEP standards

02Pre-configured CI/CD templates for automated build and PyPI distribution

03Automated setup of PEP 561 type hint markers with py.typed

04Implementation of the recommended 'src/' project layout for reliable package discovery

05Standardized dependency management with optional extras for development and documentation

060 GitHub stars

Use Cases

01Converting legacy setup.py projects to modern pyproject.toml standards

02Scaffolding new production-ready Python libraries for distribution on PyPI

03Configuring complex CLI tools with automated entry points and version management

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ricardoroche/ricardos-claude-code python-packaging

For use in Claude.ai and ChatGPT

Download Skill