Agent skill

Brewer

by Brewforge in Brewforge/homebrew-chinese

维护 Homebrew cask 到 brewforge/chinese 仓库。触发场景:(1) 用户要求添加或更新 cask;(2) 用户提供上游 cask 文件 URL;(3) 用户提到将软件收录到 brewforge。

BSD-2-ClauseAuto-check passed

Install Brewer

skills CLI
$ npx skills add Brewforge/homebrew-chinese --skill brewer -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Brewforge/homebrew-chinese brewer --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Brewforge/homebrew-chinese.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/brewer .claude/skills/brewer && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
brewer
GitHub stars
154
Token cost
~461 tokens
SKILL.md length
149 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
BSD-2-Clause

At a glance

维护 Homebrew cask 到 brewforge/chinese 仓库。触发场景:(1) 用户要求添加或更新 cask;(2) 用户提供上游 cask 文件 URL;(3) 用户提到将软件收录到 brewforge。

  • Works in 5 steps: 获取上游信息 + 下载 + 元信息 → 创建 Cask 文件 → 安装 App 并生成 zap → …
  • SKILL.md covers 流程, 1. 获取上游信息 + 下载 + 元信息, 2. 创建 Cask 文件 and 3. 安装 App 并生成 zap, plus 2 more sections
  • Calls brew and gh

What it does

Brewer is an agent skill from Brewforge/homebrew-chinese. 维护 Homebrew cask 到 brewforge/chinese 仓库。触发场景:(1) 用户要求添加或更新 cask;(2) 用户提供上游 cask 文件 URL;(3) 用户提到将软件收录到 brewforge。

Its SKILL.md is about 460 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It works with Homebrew and macOS. The repository describes itself as: 🀄️咱自己人的软件🏮咱自己人的仓库🧧. The licence is BSD-2-Clause.

Example prompts

  • “/brewer”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 获取上游信息 + 下载 + 元信息
  2. 创建 Cask 文件
  3. 安装 App 并生成 zap
  4. 检查与校正
  5. 更新 README + 提交

What it can do on your machine

Read from SKILL.md and the folder at commit 4f8d138. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • brew
    • gh

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use gh, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Brewer loads about 461 tokens when it runs. Until then it costs about 30 tokens; SKILL.md has 149 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~30
When it runs · the whole SKILL.md, loaded when a task matches
~461

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Brewforge/homebrew-chinese at commit 4f8d138, republished under its BSD-2-Clause licence (© Brewforge). 149 words, ~461 tokens.

Download SKILL.mdSave it as .claude/skills/brewer/SKILL.md (or your agent's skills folder).
name
brewer
description
维护 Homebrew cask 到 brewforge/chinese 仓库。触发场景:(1) 用户要求添加或更新 cask;(2) 用户提供上游 cask 文件 URL;(3) 用户提到将软件收录到 brewforge。

Brewer

将上游 Homebrew cask 维护到 brewforge/chinese 仓库。仓库结构和规范见 CLAUDE.md。

脚本位于 .claude/scripts/,出错时再手动介入。

流程

  1. 获取上游信息 + 下载 + 元信息(脚本自动)
  2. 创建 Cask 文件(zap 留空)
  3. 安装 App 并生成 zap(需用户交互)
  4. 检查与校正(脚本自动)
  5. 更新 README + 提交

1. 获取上游信息 + 下载 + 元信息

GitHub 项目

先用 gh api 确认版本命名规律:

bash
gh api repos/{owner}/{repo}/releases --paginate \
  --jq '.[] | {tag: .tag_name, assets: [.assets[] | .name]}' | head -20
执行 inspect 脚本

对每个架构的 DMG/ZIP 运行:

bash
.claude/scripts/brewer-inspect.sh <download_url> [arm|intel|universal]

脚本自动完成:下载 → SHA256 → 挂载/解压 → 提取 app_name / bundle_id / min_os / needs_xattr。

输出末尾的 === 汇总 === 包含所有需要的字段值。

多架构时对 arm 和 intel 各运行一次。

脚本不会卸载 DMG,后续步骤可能需要。

2. 创建 Cask 文件

路径 Casks/{首字母}/{cask-name}.rb,按 CLAUDE.md 格式编写。

根据 inspect 输出填写:

  • sha256 ← 脚本输出的 sha256
  • depends_on macos: ← 脚本输出的 min_os(映射到符号名)
  • app ← 脚本输出的 app_name
  • preflight xattr -cr ← 仅当 needs_xattr=true
  • zap trash: [] ← 先留空

macOS 版本映射:12→monterey, 13→ventura, 14→sonoma, 15→sequoia

3. 安装 App 并生成 zap

bash
brew install --cask brewforge/chinese/{cask-name}

安装完成后提示用户运行一次软件,等待用户确认。

用户确认后:

bash
brew createzap brewforge/chinese/{cask-name}

将输出填入 cask 的 zap 字段。

4. 检查与校正

bash
.claude/scripts/brewer-check.sh {cask-name}

脚本依次执行 brew style --fix → brew audit --strict → brew lc --cask。

任何命令报错时,询问用户是否重试或跳过。不要自行决定跳过。

5. 更新 README + 提交

每个软件都必须更新 README 并立即 commit,不要跳过 README,不要攒多个软件一起提交。

  • 在对应分类表格中按字母序插入新条目(不需要手动对齐列宽,插入纯内容即可,用户会用编辑器格式化表格)
  • 徽章:a.svg=开源 b.svg=闭源 1.svg=免费 2.svg=买断 3.svg=订阅
  • 检查是否有其他 cask 文件未列入 README,一并补充
  • rb 文件和 README 改动合并为单次 commit,格式:{cask-name} {version}

© Brewforge, BSD-2-Clause. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .claude/skills/brewer of Brewforge/homebrew-chinese.

Open the folder on GitHubat commit 4f8d138

Compare with similar skills

Brewer next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Brewer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Brewer this skillBrewforge/homebrew-chinese154—~461Automated safety check: PassBSD-2-Clause
Mole CLI Release Flowtw93/Mole70k—~2.5kAutomated safety check: PassGPL-3.0
Reproduce macOS Python FlavorsNuitka/Nuitka15k—~1.7kAutomated safety check: PassAGPL-3.0
CodexBar macOS Releasesteipete/CodexBar22k—~1.5kAutomated safety check: PassMIT
OrcaSlicer G-code Slicingearthtojake/text-to-cad18k—~989Automated safety check: PassMIT
Releaseeugene1g/agent-safehouse2.1k—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Runbook for assessing and executing a Mole CLI release: distribution channels, pre-flight checks, capital-V tags, build artifacts and the handoff to curated release notes.

    70k GitHub stars~2.5k tokensUpdated today
    DevelopmentAuto-check passed
  • Reproduce macOS Nuitka issues across Python distributions and GitHub Actions Python packaging.

    15k GitHub stars~1.7k tokensUpdated today
    DevOps & CloudAuto-check passed
  • CodexBar macOS Release

    steipete/CodexBar

    Releases a signed, notarized CodexBar build: confirms the changelog, resolves signing credentials from 1Password, runs the release script in tmux, and updates the Sparkle appcast and Homebrew tap.

    22k GitHub stars~1.5k tokensUpdated today
    DevOps & CloudAuto-check passed
  • OrcaSlicer G-code Slicing

    earthtojake/text-to-cad

    Slices STL, 3MF or OBJ models into printer-ready G-code with OrcaSlicer, either headless from the command line or by opening the model in the app.

    18k GitHub stars~989 tokensUpdated today
    Media & CreativeAuto-check passed
  • Release

    eugene1g/agent-safehouse

    Run the local Agent Safehouse release flow: inspect commits since the last published release, propose the next SemVer version and changelog, present a dry-run for confirmation, then update…

    2.1k GitHub stars~3.5k tokensUpdated 8 days ago
    DevelopmentAuto-check passed
  • Gearcoleco Debugging

    drhelius/Gearcoleco

    Debug and trace ColecoVision and Super Game Module games using the Gearcoleco emulator MCP server.

    141 GitHub stars~3.5k tokensUpdated yesterday
    DevelopmentAuto-check passed

Works with

Questions about Brewer

What does Brewer do?

维护 Homebrew cask 到 brewforge/chinese 仓库。触发场景:(1) 用户要求添加或更新 cask;(2) 用户提供上游 cask 文件 URL;(3) 用户提到将软件收录到 brewforge。. Brewer is an agent skill from Brewforge/homebrew-chinese.

How do I install Brewer in Claude Code?

Run `npx skills add Brewforge/homebrew-chinese --skill brewer -a claude-code`. Or copy the skill folder (.claude/skills/brewer in Brewforge/homebrew-chinese) into .claude/skills/brewer in your project. Claude Code loads it when a task matches its description.

How do I install Brewer in Codex?

Run `npx skills add Brewforge/homebrew-chinese --skill brewer -a codex`. Or copy the skill folder (.claude/skills/brewer in Brewforge/homebrew-chinese) into .agents/skills/brewer in your project. Codex loads it when a task matches its description.

Can I use Brewer in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Brewforge/homebrew-chinese --skill brewer -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/brewer, .gemini/skills/brewer, .github/skills/brewer and .opencode/skills/brewer in your project.

What does Brewer need to run?

Going by SKILL.md and its folder, Brewer needs the command-line tools its instructions call (brew and gh).

Does Brewer access the network?

SKILL.md contains no URLs. Its commands use gh, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Brewer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Brewer use?

Brewer is published under the BSD-2-Clause licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Brewer use?

About 461 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Brewer?

Skills that share tags, products or a category with Brewer: Mole CLI Release Flow (tw93/Mole, 70k stars), Reproduce macOS Python Flavors (Nuitka/Nuitka, 15k stars), CodexBar macOS Release (steipete/CodexBar, 22k stars) and OrcaSlicer G-code Slicing (earthtojake/text-to-cad, 18k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Brewer?

Brewforge (a GitHub organization) maintains it in Brewforge/homebrew-chinese, which has 154 GitHub stars. The repository was last updated on October 7, 2026.

Source: Brewforge/homebrew-chinese on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.