用途：把已完成的品牌包转成 Claude Code 的 mod（插件），让 Claude 工作时终端和桌面应用显示品牌颜色、品牌用语和 Logo。流程不盲发：先出 HTML 预览，获得批准后再生成。
前置条件：先加载品牌包，查找 brand.yaml（位于 ./、./brand/ 或 brands/<slug>/），并读取同目录的 identity.md（调色板）和 voice.md（词汇）。若还没有品牌包，先运行 brand-init，再运行 brand-identity 和 brand-voice。至少需要主色和一个 SVG Logo。需确认团队使用 Claude Code（终端或桌面应用的 Code 标签页）；mod 是 Claude Code 插件，不能在 Cursor、claude.ai 聊天或其他 agent 中运行。
主要能力：在品牌包中编写 mod.json，包含主色（脚本会派生 8 色调渐变）、logo_svg（彩色 Logo，用于桌面浅色主题）与 logo_light_svg（浅色 Logo，用于终端和桌面深色主题），以及各回合阶段和结束时的用语。终端显示 2×2 方块动画加阶段词，品牌色高光扫过；桌面应用显示带 SMIL 扫光的 Logo。结束回合用品牌自己的完成词替代默认词。/<slug>-spinner off 可恢复 Claude Code 自带 spinner 并被记住。
使用方式：运行 python3 scripts/brand-mod.py <package>/mod.json --media --check，生成可安装插件、preview.html、README.md 和 media/。--media 需要 agent-browser 和 ffmpeg；--check 运行 claude plugin validate 和 claude plugin test；两者可选，无 rsvg-convert 时终端无 Logo。打开或分享 preview.html 供审批，批准后把生成文件夹放入仓库，README 含安装步骤和 /<slug>-spinner on|off 命令，并在 brand.yaml 中设置 artifacts.mod: true。
限制：不要手改 hooks/brand.ts，未经批准不得安装或发布。终端 Logo 仅在 Ghostty 或 kitty 直接运行时显示（kitty graphics），在 herdr、tmux、zellij 或 screen 中无 Logo 也无替代。用语需来自 voice.md 中团队真实说法，避免生造短语和品牌双关。相关技能：brand-identity、brand-voice、brand-guidelines。