make-release

Automate PyPI releases via GitHub Actions with version bumps and changelog updates.

450|36|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/kasperjunge/agent-resources --skill make-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: make-release
Source: https://github.com/kasperjunge/agent-resources/tree/main/.opencode/skill/make-release
Command: npx skills add https://github.com/kasperjunge/agent-resources --skill make-release

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Release automation that handles version bumps, CHANGELOG updates, tag creation, and GitHub release publishing for Python projects.

Core Features & Use Cases

  • Prerequisites: On main branch, clean working tree, and updated CHANGELOG.
  • End-to-end Release Workflow: Validates state, runs quality checks, bumps versions in init.py and pyproject.toml, updates CHANGELOG, creates git tag, and publishes to PyPI.
  • Use Case: Release a new version to PyPI via GitHub Actions by triggering scripts.

Quick Start

Trigger a release by providing a SemVer version (for example 1.2.3) and let the workflow handle bump, changelog, tag, and PyPI publish.

Frequently Asked Questions about make-release

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

FAQPage Schema
How do I automate PyPI releases via GitHub Actions?

You can automate PyPI releases via GitHub Actions by triggering a script with a SemVer version that runs quality checks, bumps versions in project files, updates the changelog, tags the commit, and publishes the package.

What is included in a Python release workflow automation script?

A Python release workflow automation script includes validating a clean working tree on the main branch, bumping versions in pyproject.toml and __init__.py, promoting changelog entries, creating a git tag, and publishing to PyPI.

Do I need a clean working tree and an updated changelog to publish to PyPI?

Yes, publishing to PyPI requires a clean working tree on the main branch and an updated changelog. The workflow enforces these prerequisites and runs quality checks before bumping versions and tagging the release commit.

How does version bumping work across pyproject.toml and __init__.py during a release?

Version bumping during a release updates the version strings in both pyproject.toml and __init__.py based on the provided SemVer input, ensuring project metadata and runtime versions stay synchronized before tagging and publishing.

Can I generate release notes and git tags automatically for Python projects?

Yes, you can generate release notes and git tags automatically for Python projects. The workflow creates a release notes entry from the changelog and applies a git tag to the commit before pushing and publishing to PyPI.

What happens if quality checks fail during version bump and release automation?

If quality checks fail during release automation, the workflow halts before performing any version bumps, changelog updates, or git tagging operations, ensuring that only validated code is published to PyPI.