homebrew-release

Automate GitHub release artifacts and Homebrew formula updates for tap releases.

2|Updated Jul 29, 2025
One-click install
npx skills add https://github.com/kurojs/EnderDots --skill homebrew-release-kurojs
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homebrew-release
Source: https://github.com/kurojs/EnderDots/tree/main/.config/opencode/skills/homebrew-release
Command: npx skills add https://github.com/kurojs/EnderDots --skill homebrew-release-kurojs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It solves the repetitive, error-prone workflow of cutting GitHub releases and keeping Homebrew formulas/taps in sync for Gentleman-Programming homebrew-tap projects.

Core Features & Use Cases

  • Versioned release automation for two project types: Handles both Tarball-based source releases (GGA) and prebuilt binary releases (Gentleman.Dots).
  • Cross-platform artifact publication: Builds and attaches platform-specific binaries (darwin-amd64, darwin-arm64, linux-amd64, linux-arm64) and computes SHA256 checksums for formula updates.
  • Homebrew formula updates and propagation across repos: Updates the appropriate Ruby formula with correct URLs/tags/SHA256, commits changes in the main repo, then copies the formula into the homebrew-tap repository.

Quick Start

Ask the AI: "Prepare a Homebrew release for Gentleman.Dots version v2.5.1, including building binaries, creating the GitHub release notes, computing SHA256 checksums, and updating the homebrew formula files."

Frequently Asked Questions about homebrew-release

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

FAQPage Schema
How do I automate a Homebrew formula update when cutting a GitHub release?

Automating a Homebrew formula update during a GitHub release requires computing SHA256 checksums for new release artifacts and deterministically editing the formula URLs before committing. This Skill handles that end-to-end sync for homebrew-tap projects.

What is the best way to publish prebuilt binaries to a Homebrew tap?

Publishing prebuilt binaries to a Homebrew tap involves attaching platform-specific artifacts to a GitHub release and updating the corresponding Ruby formula with correct SHA256 checksums. This Skill automates attaching darwin and linux binaries and pushing formula updates.

How do I compute SHA256 checksums for Homebrew formula updates?

Computing SHA256 checksums for Homebrew formula updates involves hashing the downloaded platform-specific release artifacts to ensure integrity. This Skill automatically calculates these checksums and injects them into the appropriate formula files.

Can I use this Homebrew release automation for both source tarballs and prebuilt binaries?

This Homebrew release automation supports both tarball-based source releases for GGA projects and prebuilt binary releases for Gentleman.Dots. It adjusts artifact publication and formula updates based on the specific project type triggered by version bumps or tags.

Does this Homebrew release workflow support cross-platform binaries like darwin-arm64 and linux-amd64?

This workflow supports cross-platform binaries by building and attaching artifacts for darwin-amd64, darwin-arm64, linux-amd64, and linux-arm64. It computes the necessary SHA256 checksums for each platform to update the Homebrew formula correctly.

Why do my Homebrew formula edits fail to sync with my GitHub release tags?

Homebrew formula edits fail to sync when tag formatting is inconsistent between the GitHub release and the formula references. This Skill requires consistent tag formatting to deterministically edit formula files before pushing commits and releases.