release-flow

Automates release pipelines with conventional commits and semantic-release.

3|Updated Feb 15, 2026
One-click install
npx skills add https://github.com/pvliesdonk/agents.md --skill release-flow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-flow
Source: https://github.com/pvliesdonk/agents.md/tree/main/claude-skills/release-flow
Command: npx skills add https://github.com/pvliesdonk/agents.md --skill release-flow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the complex process of releasing software, from version bumping and tagging to publishing to PyPI and Docker Hub, ensuring consistency and reducing manual errors.

Core Features & Use Cases

  • Automated Versioning: Uses conventional commits to automatically determine and apply version bumps (patch, minor, major).
  • CI/CD Integration: Orchestrates GitHub Actions for a multi-stage release pipeline.
  • Publishing: Handles PyPI trusted publishing and Docker multi-arch image builds and pushes to GHCR.
  • Use Case: After merging a feature branch with conventional commits, this skill will automatically create a new release tag, update the changelog, publish the new version to PyPI, and build/push Docker images.

Quick Start

Use the release-flow skill to perform a patch release.

Frequently Asked Questions about release-flow

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

FAQPage Schema
How do I automate Python package publishing to PyPI using GitHub Actions?

Automate Python package publishing to PyPI using GitHub Actions by configuring trusted publishing within a multi-stage release pipeline. This approach integrates semantic-release to handle version bumping and orchestrates the workflow to push packages automatically upon merging conventional commits.

What is semantic release and how does conventional commit versioning work?

Semantic release automates versioning by parsing conventional commit messages to determine the bump type. Patch, minor, or major version increments are applied automatically, generating an updated changelog and creating a new release tag without manual intervention.

How do I build and push multi-arch Docker images to GHCR in a CI/CD pipeline?

Build and push multi-arch Docker images to GHCR by orchestrating the build process within GitHub Actions. The release pipeline triggers image creation and pushes the multi-architecture manifests directly to the GitHub Container Registry alongside PyPI publishing.

Does GitHub Actions support trusted publishing for PyPI releases?

Yes, GitHub Actions supports trusted publishing for PyPI releases. The release pipeline orchestrates this OIDC-based trusted publishing mechanism, eliminating the need for long-lived API tokens and securely authenticating the workflow directly with PyPI.

How do I generate a changelog automatically from conventional commits?

Generate a changelog automatically from conventional commits by integrating semantic-release into your CI/CD pipeline. The tool reads commit history, determines the version bump, and writes the corresponding changelog entries during the automated release workflow.

What is the best way to manage a multi-stage release workflow for Docker and PyPI?

The best way to manage a multi-stage release workflow for Docker and PyPI is orchestrating GitHub Actions to handle both targets. A unified pipeline uses semantic-release for tagging, then concurrently publishes to PyPI via trusted publishing and builds multi-arch images for GHCR.