release

Automate Python release workflows by syncing versions, tagging, and triggering CI pipelines.

6|1|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/wwulfric/peeka --skill release-wwulfric
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release
Source: https://github.com/wwulfric/peeka/tree/main/.agents/skills/release
Command: npx skills add https://github.com/wwulfric/peeka --skill release-wwulfric

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Release automation for Python projects streamlines version bumps, commits, tagging, and pushing, while CI handles PyPI publishing and GitHub Release creation.

Core Features & Use Cases

  • Automates semantic version bumps (patch/minor/major) and explicit version releases.
  • Coordinates git operations (commit, tag, push) and triggers CI workflows for publishing to PyPI and creating GitHub Releases.
  • Supports first-time releases, pre-release validations, and post-release postmortem analysis using the built-in postmortem workflow.

Quick Start

Invoke the release skill with a version bump command, for example '/release minor'.

Frequently Asked Questions about release

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

FAQPage Schema
How do I automate Python package releases to PyPI and GitHub?

Automating Python package releases requires syncing version files, committing changes, tagging, and pushing to trigger CI pipelines for PyPI publishing and GitHub Release creation. This workflow coordinates git operations with GitHub Actions to publish packages automatically.

How do I bump semantic versions for patch, minor, and major releases in git?

Bumping semantic versions for patch, minor, and major releases updates synchronized version files across your Python project before committing and tagging. The automation applies the selected version bump level consistently to ensure all configuration files match the new release tag.

Do I need GitHub Actions and PyPI trusted publisher configured before releasing?

Yes, GitHub Actions workflows and PyPI trusted publisher setup are required prerequisites before releasing. The release automation triggers existing CI pipelines to handle PyPI publishing and GitHub Release creation, relying on these pre-configured environments to complete the end-to-end workflow.

What is the best way to handle first-time Python package releases with version automation?

Handling first-time Python package releases with version automation uses an end-to-end workflow that syncs initial version files, creates the first commit and tag, and triggers CI pipelines. It validates pre-release conditions on the master branch before pushing changes to ensure a clean working directory.

Why does my release workflow require a clean git working directory on master?

Release workflows require a clean git working directory on the master branch to ensure version file synchronization and tagging apply only to committed state. This prevents uncommitted changes from interfering with semantic version bumps and CI pipeline triggers for PyPI publishing.

Can I run post-release analysis and postmortem checks after a PyPI publish?

Yes, you can run post-release analysis and postmortem checks after PyPI publishing using a built-in postmortem workflow. This evaluates the release process outcome, validating that CI pipelines completed successfully and GitHub Releases were created properly for the published version.