homebrew-cask-authoring — Claude Code skill: how to install
homebrew-cask-authoring guides creation, validation, and updates for macOS and Linux Homebrew Casks while adhering to official upstream merge requirements.
no license 128 installs ★ 20 updated 2026-10-23
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a claude-codeWhat homebrew-cask-authoring does
This skill instructs coding agents on drafting and bumping packages in homebrew-cask. It structures tokens, separates OS dependencies between on_macos and on_linux, and organizes binary architectures for Apple silicon or Intel. Deprecated items such as verified: parameters in URLs are removed directly.
Pre-flight checks guard against upstream rejections. Repositories and their domains must exist for at least 30 days. GitHub targets need at least 75 stars, or 225 when opened by project maintainers. macOS binaries must pass Gatekeeper notarization checks before drafting stanzas.
Official command-line tools take absolute precedence. If directives in this skill contradict output from brew style or brew audit, follow the CLI tool directly.
What it helps with
- draft compliant Homebrew Cask stanzas for macOS or Linux software
- select proper cask tokens without redundant platform terms
- structure uninstall and zap stanzas that handle launchd services
- verify repository notability and notarization prior to PR submission
Example prompts for the agent
- Draft a cross-platform Homebrew cask with an AppImage for Linux and a DMG for macOS
- Check whether this repository meets the Homebrew Cask acceptance thresholds
- Write uninstall and zap stanzas for an application with helper background tasks
How to install homebrew-cask-authoring
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a claude-code2Manually: put the files in place
~/.claude/skills/homebrew-cask-authoring/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/homebrew-cask-authoring/
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a codex2Manually: put the files in place
.agents/skills/homebrew-cask-authoring/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a cursor2Manually: put the files in place
.cursor/skills/homebrew-cask-authoring/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install connorads/dotfiles skills/homebrew-cask-authoring2Manually: put the files in place
.github/skills/homebrew-cask-authoring/SKILL.md1Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a gemini-cli2Platform CLI
gemini skills install https://github.com/connorads/dotfiles --path skills/homebrew-cask-authoringManually: put the files in place
.devin/skills/homebrew-cask-authoring/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about homebrew-cask-authoring
How to install homebrew-cask-authoring in Claude Code?
Run npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a claude-code. The skill lands in ~/.claude/skills/homebrew-cask-authoring/SKILL.md.
What does homebrew-cask-authoring do?
It guides your agent through packaging desktop applications for Homebrew. It covers token naming, notarization verification, architecture logic, and proper cleanup stanzas.
What happens if a guideline contradicts brew audit?
The official CLI output always wins. brew audit and brew style reflect Homebrew's latest release, taking priority over any instruction in this skill.