Can I use this to validate my README before uploading?

Yes, the skill includes instructions and command-line snippets for using tools like twine check to verify your README markup locally before publishing.

Is it compatible with modern Python package managers like uv?

Absolutely, the skill includes optimized workflows for building and publishing packages using uv, as well as traditional pip and twine methods.

Does it support Sphinx-specific roles in RST?

It provides guidance on removing or converting Sphinx roles (like :py:func:) that PyPI's renderer doesn't support, helping you avoid common 'Unknown interpreted text role' errors.

Can this skill help me choose between Markdown and RST?

Yes, it provides a selection strategy to help you decide based on your project's documentation infrastructure, platform compatibility needs, and team preferences.

How does it help with pyproject.toml configuration?

It provides precise TOML snippets for configuring the readme field, including specific content-type variants for GitHub Flavored Markdown and CommonMark.

PyPI README Creator

Name: PyPI README Creator
Author: Jamie-BitFlight

byJamie-BitFlight

•

Content Management

Generates and validates professional, PyPI-compliant README files in Markdown or reStructuredText to ensure perfect rendering across Python package registries.

About

PyPI README Creator is a specialized tool for Python developers designed to streamline the documentation process for package releases. It automates the generation of README files in both Markdown and reStructuredText (RST), ensuring they meet the strict rendering requirements of the Python Package Index (PyPI) while maintaining cross-platform compatibility with GitHub, GitLab, and BitBucket. By providing domain-specific guidance on formatting, pyproject.toml configuration, and twine validation, this skill helps developers eliminate common rendering errors, manage Sphinx integration, and present their projects with professional clarity.

Key Features

Multi-format support for Markdown (GFM/CommonMark) and reStructuredText (RST)
Integration with Sphinx via sphinx-readme for single-source documentation workflows
PyPI-specific validation to prevent rendering errors like unknown roles or directives
11 GitHub stars
Pre-configured templates for project identity, installation, and quick start sections
Automated pyproject.toml metadata configuration for README inclusion

Use Cases

Preparing a new Python package for its first publication to PyPI with correct metadata
Converting complex Sphinx documentation into a simplified, PyPI-compatible RST format
Troubleshooting and fixing broken README rendering or markup errors on a PyPI project page

About

Key Features

Multi-format support for Markdown (GFM/CommonMark) and reStructuredText (RST)
Integration with Sphinx via sphinx-readme for single-source documentation workflows
PyPI-specific validation to prevent rendering errors like unknown roles or directives
11 GitHub stars
Pre-configured templates for project identity, installation, and quick start sections
Automated pyproject.toml metadata configuration for README inclusion

Use Cases

Preparing a new Python package for its first publication to PyPI with correct metadata
Converting complex Sphinx documentation into a simplified, PyPI-compatible RST format
Troubleshooting and fixing broken README rendering or markup errors on a PyPI project page