deploy-pypi

Automate PyPI publishing with pyproject.toml validation and Trusted Publisher authentication.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/jrc1883/popkit-claude --skill deploy-pypi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: deploy-pypi
Source: https://github.com/jrc1883/popkit-claude/tree/main/skills/pop-deploy-pypi
Command: npx skills add https://github.com/jrc1883/popkit-claude --skill deploy-pypi

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validates pyproject.toml, builds, signs, and publishes to PyPI securely with optional TestPyPI support.

Core Features & Use Cases

  • pyproject validation: ensures required fields and tooling compatibility.
  • Trusted publishing: leverages secure workflows and tokens.
  • Dry-run and test publish: supports pre-release verification.

Quick Start

/popkit:deploy setup pypi to generate PyPI publishing workflows.

Frequently Asked Questions about deploy-pypi

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish Python packages to PyPI securely?

Publishing to PyPI securely uses Trusted Publisher (OIDC) authentication instead of static tokens. This Skill automates the entire workflow—validating your pyproject.toml, preparing GitHub Actions, and handling version bumps—so your package reaches PyPI with cryptographic verification and minimal manual steps.

Can I test my PyPI package before publishing to production?

Yes, this Skill supports TestPyPI as a dry-run environment. You can publish to TestPyPI first to verify your package metadata, dependencies, and build output work correctly before releasing to the live PyPI registry.

What does pyproject.toml validation check for when publishing?

Pyproject.toml validation ensures required metadata fields are present, build-system configuration is compatible, and the py.typed marker exists for type-hint support. This prevents common publishing errors before your package reaches PyPI.

Does this work with GitHub Actions for CI/CD publishing?

Yes, this Skill generates GitHub Actions workflows that automate PyPI publishing using Trusted Publisher authentication. It integrates with your CI pipeline to publish on release triggers without storing PyPI credentials in your repository.

What project structure does this Skill require?

This Skill applies to Python projects using pyproject.toml with a src/ layout and modern build tooling. It validates your project structure and build-system compatibility before automating the publish workflow.

Can I automate version bumps alongside PyPI publishing?

Yes, this Skill handles version management for both PyPI and TestPyPI release scenarios. It automates version bumping as part of your publishing workflow, keeping your package version in sync across releases.