release

Automate pgdbm version bumps, CHANGELOG updates, git tagging, and PyPI publishing.

Updated Jul 28, 2025
One-click install
npx skills add https://github.com/juanre/pgdbm --skill release-juanre
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/juanre/pgdbm/tree/main/.claude/skills/release
Command: npx skills add https://github.com/juanre/pgdbm --skill release-juanre

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill guides you through releasing a new pgdbm library version to PyPI, automating the repetitive, error-prone steps.

Core Features & Use Cases

  • Version bumping and file updates: updates pyproject.toml, src/pgdbm/version.py, and .claude-plugin/plugin.json to the new version.
  • Changelog and release artifacts: updates CHANGELOG.md and creates git tags for the release; supports both single-service and multi-module release workflows.
  • Publish and verification: builds and uploads to PyPI, verifies test suite passes before publishing.

Quick Start

Use the release skill to guide me through bumping the version and publishing to PyPI.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate releasing a Python package to PyPI?

Automate releasing to PyPI by automating version bumps, updating CHANGELOG.md, creating git tags, and publishing builds. This Skill guides you through the complete release workflow, enforcing test checks before publishing to ensure a deterministic, auditable release.

What files need to be updated when releasing a new version?

Release workflows update pyproject.toml, src/pgdbm/__version__.py, .claude-plugin/plugin.json, and CHANGELOG.md. This Skill coordinates all file updates together, ensuring version consistency across your project before publishing.

Can I use this for multi-module Python projects?

Yes, this Skill supports both single-repo and multi-module release workflows. It automates version bumping, changelog updates, and git tagging across your module structure, then publishes to PyPI as a coordinated release.

How do I ensure my release is safe before publishing to PyPI?

This Skill enforces test suite verification before publishing, requiring run-test checks to pass. It creates an auditable release record through git tags and guides you through each step, reducing manual error in the publish process.

What's the difference between versioning and releasing to PyPI?

Versioning updates version numbers in your files; releasing publishes that versioned code to PyPI. This Skill combines both—it bumps versions, updates release artifacts like CHANGELOG.md and git tags, then builds and uploads your package to PyPI.

Do I need to know git tagging to use this release workflow?

No, this Skill handles git tagging automatically as part of the release process. It guides you through version bumping and publishing while managing git tags, so you don't need to tag manually or understand tagging mechanics.