homebrew-cask-authoring

Automate creation, validation, and submission of Homebrew Casks.

15|1|Updated Jul 9, 2023
One-click install
npx skills add https://github.com/connorads/dotfiles --skill homebrew-cask-authoring
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: homebrew-cask-authoring
Source: https://github.com/connorads/dotfiles/tree/main/.claude/skills/homebrew-cask-authoring
Command: npx skills add https://github.com/connorads/dotfiles --skill homebrew-cask-authoring

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill eliminates the complex, error-prone process of creating and updating Homebrew Casks, ensuring your macOS app packages install flawlessly every time.

Core Features & Use Cases

  • Cask Creation: Generate properly formatted Homebrew Casks with correct token naming and required stanzas.
  • Validation & Testing: Automatically run brew style, audit, and installation tests to catch issues before submission.
  • Use Case: When you discover a new macOS app that's not in Homebrew, use this Skill to create a complete cask file, validate it against all Homebrew standards, and test the installation process locally before submitting to the official repository.

Quick Start

Create a new Homebrew cask for the application 'MyApp' with version 2.1.0 and download URL 'https://example.com/MyApp.dmg'.

Frequently Asked Questions about homebrew-cask-authoring

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

FAQPage Schema
How do I create a Homebrew Cask for a macOS application?

Creating a Homebrew Cask involves generating a properly formatted cask file with correct token naming, download URL, sha256 checksum, and required stanzas like app, uninstall, and zap blocks. This Skill automates that process end-to-end, handling token derivation, architecture-specific blocks, URL verification, and integrity validation to ensure your cask meets Homebrew standards before submission.

Can I automate validation and testing of Homebrew Casks before submission?

Yes. This Skill runs brew style, audit, and installation tests automatically to catch formatting and functional issues before you submit to the official repository. It validates token naming, architecture compatibility, URL integrity, and uninstall logic, then performs local install and uninstall workflows to verify the cask works correctly.

What's the best way to handle architecture-specific installation blocks in Homebrew Casks?

Homebrew Casks support on_arm and on_intel blocks for architecture-aware installations. This Skill automatically generates and validates these stanzas based on your application's requirements, ensuring proper token interpolation and URL selection for each architecture, then tests both configurations locally.

How do I ensure sha256 checksums and URLs are correct in a Homebrew Cask?

This Skill verifies domain ownership and sha256 integrity as part of cask creation, validating that download URLs are legitimate and checksums match the actual application binaries. It automates hash calculation and domain verification to prevent installation failures and security issues.

Do I need to manually run brew style and audit commands on Homebrew Casks?

This Skill runs brew style, audit, install, and uninstall checks automatically as part of its validation workflow, eliminating manual testing steps. You get a fully tested cask ready for submission without running commands separately.

What happens if my Homebrew Cask fails livecheck or installation tests?

This Skill includes livecheck automation and local test workflows that catch failures before submission. If issues occur, the validation output shows which stanzas or configurations need adjustment, helping you fix token naming, URL interpolation, uninstall logic, or architecture blocks before resubmitting.