python-package-dev

What problem does it solve?

This Skill helps you turn research code into a well-structured, installable Python package that is easy to test, document, and publish for reuse and reproducibility.

Core Features & Use Cases

• pyproject.toml-first packaging: Defines build system and project metadata using modern PEP 517/518 workflows for consistent packaging.
• Research-grade testing with pytest: Adds unit/integration tests and encourages measurable quality via coverage (pytest-cov).
• Sphinx documentation & API reference: Generates API docs from docstrings (autodoc) to support maintenance and academic adoption.
• Publishing for academic software: Prepares builds for distribution to PyPI (and optionally conda workflows) using standard tooling.
• Use Case: You have a statistical analysis toolkit used across multiple papers and notebooks; you want one reusable Python package with automated tests and Sphinx docs so collaborators can install and cite the same version.

Quick Start

Use this skill to set up your repository with a src-layout package, write tests with pytest, generate Sphinx API docs, and prepare a PyPI-ready release.