New Cask

If you've ever wanted to contribute a macOS app to Homebrew but got lost in the cask format, token naming rules, and livecheck strategies, this walks you through the whole process. It spawns specialized agents that handle pre-flight checks, download the app and extract metadata, figure out update detection, write the cask file with proper stanzas, and submit the PR. The workflow includes running audit tests, the createzap tool for cleanup discovery, and test installs. It's opinionated about the right order to do things and knows to use Homebrew's own generate_cask_token tool instead of guessing names. Saves you from reading cookbook docs and style guides while clicking between six terminal tabs.

GitHub stars: 460
last updated: Jun 7, 2026

View on GitHub

Install

$ npx -y skills add malob/nix-config --skill new-cask --agent claude-code

Installs into .claude/skills of the current project.

Files

Creating a New Homebrew Cask

You are orchestrating the creation of a new Homebrew cask. This skill coordinates multiple specialist agents and scripts to complete the workflow.

IMPORTANT: This skill runs in the main conversation context. You will use the Task tool to spawn agents for specialized work.

Input

URL provided: $ARGUMENTS

If no URL was provided, ask the user for:

The app name, OR
A download URL (direct link to DMG/ZIP), OR
The product homepage (you'll find the download link)

Workflow Overview

1. Pre-flight checks    → Agent: pre-flight-checker
2. Download & inspect   → Agent: app-inspector
3. Livecheck strategy   → Agent: livecheck-advisor
4. Write cask file      → Agent: cask-writer
5. Testing              → Automated tests, install, createzap, uninstall
6. Submit PR            → Agent: pr-submitter

Create a task list to track progress through these steps.