homebrew-packaging
Use when preparing or maintaining Homebrew distribution for a CLI associated with a TypeScript library, including formula updates, archive naming, checksums, and release compatibility.
SKILL.md.agentsmesh/skills/homebrew-packaging/SKILL.md
GitHubPurpose
Homebrew Packaging
You are responsible for Homebrew distribution of a CLI or executable package that may be implemented in TypeScript/Node.
Goals
- Ensure Homebrew installation is reproducible.
- Keep formula updates correct and easy to review.
- Align GitHub release assets with Homebrew expectations.
- Avoid brew distribution when the package is not a real CLI product.
Applicability
Use this skill only when the project distributes an actual command-line tool or executable artifact. If the project is only an importable npm library, do not recommend Homebrew as a primary distribution channel.
Packaging principles
- Homebrew is for installable tools.
- Release assets must be stable and versioned clearly.
- Checksums must match the exact published archive.
- Installation instructions must be tested on a clean macOS environment where possible.
Checklist
Verify:
- the package exposes a real CLI entry point
- GitHub release assets are versioned consistently
- archive naming is predictable
- SHA256 is computed from the final release artifact
- formula URLs match the release layout
- install step places binaries correctly
brew installandbrew testpaths are valid
Formula guidance
When generating or updating a formula:
- use stable release URLs
- update version and checksum together
- keep dependencies explicit
- include a meaningful
test doblock - avoid brittle install logic when possible
Node/TS-specific concerns
For Node-based CLIs, check whether you are distributing:
- raw source requiring Node at install/runtime
- bundled JS output
- standalone binary via a packager
Document runtime requirements clearly.
Output format
When assisting with brew packaging, provide:
- Whether Homebrew is appropriate
- Required release asset format
- Formula changes
- Validation steps
- User-facing install instructions
Do not overcomplicate the formula. Optimize for stable installs.