Should I use Markdown or reStructuredText for my Python project?

This skill provides a strategy for choosing: Markdown is generally better for simplicity and GitHub compatibility, while RST is preferred for projects heavily integrated with Sphinx.

Does this work with the modern pyproject.toml format?

Yes, it provides specific configurations for declaring README files and content types within the [project] table of pyproject.toml.

How do I check if my README will render correctly before uploading?

The skill guides you through using 'twine check' after building your distribution packages to validate markup before publication.

Why does my README look broken on PyPI but fine on GitHub?

PyPI uses a specific renderer that often restricts certain Sphinx extensions or custom HTML tags allowed by GitHub; this skill helps you identify and fix these incompatibilities.

PyPI README Creator

Name: PyPI README Creator
Author: Jamie-BitFlight

byJamie-BitFlight

•

콘텐츠 관리

Generates professional, PyPI-compliant README files in Markdown or reStructuredText to ensure correct rendering across Python package indexes.

The pypi-readme-creator skill helps developers navigate the technical requirements of Python package documentation, ensuring README files render flawlessly on PyPI, GitHub, and GitLab. It provides expert guidance on choosing between Markdown and reStructuredText, configuring pyproject.toml metadata, and troubleshooting common rendering errors with tools like twine check. Whether you are launching a new project or migrating Sphinx documentation, this skill ensures your package's first impression is polished, accessible, and technically accurate.

주요 기능

01Validation of markup to prevent rendering errors on PyPI

0210 GitHub stars

03Sphinx documentation integration using sphinx-readme

04Metadata configuration for pyproject.toml and setup.py

05Platform-specific syntax support for GitHub, GitLab, and BitBucket

06Automated PyPI-compliant README generation in Markdown and RST

사용 사례

01Converting existing Sphinx documentation into a PyPI-compatible format

02Troubleshooting 'invalid markup' errors during the twine check process

03Preparing a new Python package for publication on the Python Package Index (PyPI)

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jamie-bitflight/claude_skills pypi-readme-creator

For use in Claude.ai and ChatGPT

Download Skill