# homebrew-cask-authoring

homebrew-cask-authoring guides creation, validation, and updates for macOS and Linux Homebrew Casks while adhering to official upstream merge requirements.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 128 installs · ★ 20 repo stars
- Author: connorads
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/connorads/dotfiles/tree/HEAD/skills/homebrew-cask-authoring/SKILL.md
- Updated: 2026-10-23
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/homebrew-cask-authoring

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/homebrew-cask-authoring/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/homebrew-cask-authoring/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/homebrew-cask-authoring/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/homebrew-cask-authoring/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install connorads/dotfiles skills/homebrew-cask-authoring
```

2. **Manually: put the files in place**
- File: `.github/skills/homebrew-cask-authoring/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/connorads/dotfiles --path skills/homebrew-cask-authoring
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/homebrew-cask-authoring/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add connorads/dotfiles --skill homebrew-cask-authoring -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/connorads/dotfiles/tree/HEAD/skills/homebrew-cask-authoring/SKILL.md

## When to use it
- 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
- 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

## Similar
- [homebrew-formula-maintenance](https://affpapa.org/en/nevibecode/skills/homebrew-formula-maintenance.md) — skill · 373 installs
- [mac-maintenance](https://affpapa.org/en/nevibecode/skills/mac-maintenance.md) — skill · 117 installs
- [release-lotion](https://affpapa.org/en/nevibecode/skills/release-lotion.md) — skill · ★ 156 repo stars
- [ghostty-config](https://affpapa.org/en/nevibecode/skills/ghostty-config.md) — skill · ★ 173 repo stars
- [disk-hygiene](https://affpapa.org/en/nevibecode/skills/disk-hygiene.md) — skill · 273 installs
- [puremac-macos-cleaner](https://affpapa.org/en/nevibecode/skills/puremac-macos-cleaner.md) — skill · 491 installs

From the same set: [connorads/dotfiles](https://affpapa.org/en/nevibecode/by/connorads/dotfiles.md) — 2 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
