Does it support dry runs?

Yes, the underlying automation supports dry-run modes to preview version changes and commands without executing git pushes or releases.

Which programming languages does the Release Runbook support?

It is language-agnostic and includes patterns for package.json, pyproject.toml, Cargo.toml, go.mod, and other common versioning files.

Can I run custom test suites before a release is finalized?

Yes, the skill encourages running project-defined tests like 'make test' or 'npm test' and will halt the process if tests fail.

How does it handle Homebrew updates?

Once the GitHub release is live, the skill can automatically fetch the new source tarball, calculate its SHA256 hash, and update the corresponding Formula file.

Release Runbook

Name: Release Runbook
Author: nibzard

bynibzard

•

Deployment & DevOps

Automates the end-to-end software release process including version bumping, testing, tagging, and GitHub release creation.

The Release Runbook skill provides a standardized, reliable workflow for cutting new software releases across various programming environments. It guides Claude through essential preflight repository checks, Semantic Versioning (SemVer) increments, and automated testing to ensure code quality before publication. By orchestrating the git tagging, pushing, and GitHub release creation processes, it eliminates manual errors and ensures consistency. Additionally, it handles downstream tasks like updating Homebrew formulas with new source URLs and SHA256 hashes, making it an essential tool for maintainers of open-source and private projects.

Key Features

0112 GitHub stars

02Automated Semantic Versioning (SemVer) bumping across multiple configuration files

03Post-release Homebrew formula updates with automated SHA256 hashing

04Preflight repository state and GitHub authentication verification

05Seamless GitHub release generation with automated tag and note creation

06Configurable test execution and smoke check validation prior to tagging

Use Cases

01Automating the publication of new major, minor, or patch versions of a software project

02Ensuring consistent release notes and tagging across a multi-contributor repository

03Updating distribution manifests like Homebrew formulas immediately after a GitHub release

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add nibzard/looper release-runbook

For use in Claude.ai and ChatGPT

Download Skill