Homebrew Formula Maintenance

Keeps your Homebrew formulas in sync with PyPI releases for Python CLIs. You update the URL and SHA256, regenerate resource blocks for dependencies, then run brew install, test, and audit before pushing to your tap. The workflow includes scripts like update_formula.sh and generate_resources.py for automating the repetitive parts, plus patterns for both full virtualenv formulas with pinned dependencies and minimal venv setups. Works well in CI with GitHub Actions triggering on tags. The progressive disclosure is honest about this being formulaic maintenance work, which it absolutely is, but the structure means you won't skip the audit step at 11pm before a release.

skills.sh installs: 366
GitHub stars: 79
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add bobmatnyc/claude-mpm-skills --skill homebrew-formula-maintenance --agent claude-code

Installs into .claude/skills of the current project.

Files

Homebrew Formula Maintenance

Overview

Use this workflow to keep Homebrew formulas in sync with PyPI releases for Python CLIs. The pattern in your taps is: update version + sha, refresh resource blocks when needed, run brew install/test/audit, then push the tap update (manually or via CI).

Quick Start (manual bump)

Verify the PyPI release exists and grab the sdist URL + SHA256.
Update the url and sha256 in the formula.
Refresh resource stanzas if the formula uses virtualenv_install_with_resources.
Test: brew install --build-from-source + brew test + brew audit --strict.
Update changelog/tag and push the tap repo.