⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v0.5.1

brewreel

@finderchangchang⭐ 113 stars

精酿 · BrewReel：做竖版产品宣传短片（1080x1920，15–45 秒，抖音/视频号/小红书）。用户要做产品宣传片、推广短视频、App 介绍视频、功能演示视频、上新短片、带货片头时使用。支持软件、餐饮、电商实物、教培、美业、文旅住宿六个行业，支持中英双语。你只写一份分镜 JSON（storyboard.json），画面由现成镜头组件画，校验脚本拦规则和行业合规，一条命令出片（带原创配乐和音效，可选 MiniMax / 阿里云 / 火山引擎配音）。

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐⭐⭐ 113 on GitHubGitHub ↗

Popular

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

精酿 · BrewReel

便宜模型，也能酿出好片：写一份产品简报，AI 挑镜头、写文案，一条命令出一支竖版宣传片。

Stars Forks Version DeepSeek Harness Remotion License

官网 · 首次出片指南 · 产品简报模板 · 演示视频 · 历史版本 · 更新日志 · 在 DeepSeek Harness 里用 · 姊妹项目 Jev 聊天助手 · English

原名 promo-video-skill / 蒸馏视频，旧地址自动跳转。

❤️赞助商

想出现在这里？加微信 jskjkf007，添加时请备注「BrewReel 商务合作」。

截图

下面都是实际渲染的画面。分镜都在仓库里，产品和数据都是虚构的；演示视频（v0.3.0 附件，约 5 MB）是三种配方的实际渲染效果。

三种配方

六个行业（每张图左边是第 0 帧封面，右边是片中一帧）

这 9 份分镜在 examples/（都是 cards 配方），quiz 和 journey 的样例在 styles/quiz/examples/、styles/journey/examples/。每份都能直接通过校验并用 make.mjs 出片。

为什么用它

  • 便宜模型只做它做得好的事。 模型只写一份 storyboard.json：挑镜头、填文字，不写代码、不算坐标。版式、动效、节奏都在现成组件里。
  • 配方由强模型先调好。 每种风格先由强模型做到位，再写成组件和校验规则；便宜模型照着填，出片水准由配方兜底。
  • 合规红线先拦一遍。 内置《广告法》极限词、六个行业的合规规则、断词换行、安全区等几十条校验，报错用中文写清楚哪里要改。
  • 一条命令出片。 校验 → 配乐 → 渲染 → 拼图 → 检查帧，全自动；自查有 ✗ 的片子不交付。
  • 配乐现场合成，没有版权问题。 按镜头切点卡拍，响度统一到 -16 LUFS。
  • 中英双语。 字幕可选中文或英文；英文片每半拍扫一次画面，混进汉字就不交付。
  • 开源、可商用。 Apache-2.0，注明出处即可；渲染出的视频不要求署名。

平台支持

用法状态说明
Claude Code / Codex / opencode 等能读 SKILL.md 的 AI 编程助手✅ 可用把仓库装成 skill，助手照 SKILL.md 写分镜、跑校验、出片
DeepSeek Harness 插件 dsh-brewreel⚠️ 已发布到 npm7 个工具负责校验、出片、核对；还没接真实 DeepSeek 模型实测
无 agent 脚本 scripts/llm_make.py✅ 可用直接调 OpenAI 兼容接口（默认 DeepSeek），简报进、视频出，校验报错自动回喂重试
运行环境要求
操作系统Windows（仅 x64）/ macOS ≥ 15 / Linux（glibc ≥ 2.35，需要 libnss3 / libgbm / libasound2 等共享库；不支持 Alpine、NixOS）
Node.js≥ 18（建议 20 LTS 或更高，本仓库在 Node 22 上测试过）；DeepSeek Harness 插件要 22.19+ 的 22.x 或 24+
Python3.10+；配乐脚本要 numpy / scipy，llm_make.py 只用标准库
首次下载渲染依赖约几百 MB，外加约 110 MB 的 Chrome Headless Shell

成片 1080×1920（journey 默认 1080×1350），30 fps，带配乐和音效。

快速开始

1. 装依赖。

git clone https://github.com/Finderchangchang/brewreel.git
cd brewreel/template && npm install && npx remotion browser ensure
cd .. && pip install numpy scipy

npm install 装渲染引擎（lock 文件里带 7 个平台的 Remotion compositor，换平台不用重新生成）；npx remotion browser ensure 下载一次 Chrome Headless Shell，供无头渲染用。

2. 跑一个样例，确认装好了。

node scripts/validate.mjs examples/ledger.json
node scripts/make.mjs examples/ledger.json --out ../brewreel-out/ledger

第一条校验通过就说明装好了。第二条出片要几分钟，终端最后一行是「交付：<mp4 路径>」；输出目录里有 video.mp4、拼图 sheet.png、检查帧 check/、report.txt 和交付清单 manifest.json。--out 不能指向仓库里面。

3. 让 AI 写分镜。 三选一：

  • 装成 skill：把整个仓库 clone 到 ~/.claude/skills/brewreel/（Claude Code）或 ~/.agents/skills/brewreel/（通用约定），或用你工具自带的 skill 安装命令指向本仓库。然后把简报交给助手（模板见 brief-template.md），让它照 SKILL.md 出片。
  • 无头脚本：不需要 agent，见下面的「用便宜模型直接跑」。
  • DeepSeek Harness：装插件后模型用工具校验和出片，见「在 DeepSeek Harness 里用」。

用便宜模型直接跑

scripts/llm_make.py 直接调 OpenAI 兼容接口：简报进、视频出，校验报错会原样回喂给模型重试（最多 3 次）。

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic   # 仅当把 DeepSeek 接到 Claude Code 时需要
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-flash[1m]

# 或者直接用无头脚本，不接 Claude Code：
export LLM_API_KEY=<你的 DeepSeek API Key>
export LLM_BASE_URL=https://api.deepseek.com
export LLM_MODEL=deepseek-chat
python scripts/llm_make.py path/to/brief.md

Windows PowerShell 用 $env:LLM_API_KEY="..." 代替 export。以上都是占位符，换成你自己的 key；不要把 key 提交进仓库或写进 issue。也可以把这些变量写进 AI 编程助手自己的全局配置（如 ~/.claude/settings.json），这是可选做法，本仓库不会替你改任何全局配置。加 --dry-run 不调接口、不读密钥，只把拼好的提示写出来并估算 token 数。

在 DeepSeek Harness 里用

仓库自带一个 DeepSeek Harness（dsh）插件，放在 integrations/deepseek-harness/，包名 dsh-brewreel（原名 dsh-distill-video，从旧版升级见插件 README 的「从 dsh-distill-video 升级」）。装上后，模型照着 skill 写分镜，校验、出片、核对都调插件的工具完成，不用自己拼 node scripts/… 命令；出片在后台跑、报进度，输出路径和子进程拿到的环境变量都受插件限制。

需要 dsh 0.1.7-rc.2 或更高的 0.1.x。npm 上 dsh 的 latest 标签目前还指向更早的 0.1.5-rc.3，所以安装时要写明版本号。另外要有 Node.js 22.19+ 的 22.x 或 24+，以及 pnpm（dsh plugin 靠 pnpm 装插件）。从 npm 安装：

npm install -g @deepseek-ai/[email protected] pnpm    # 还没装 dsh 时
dsh plugin --profile web add dsh-brewreel
dsh web

web 可以换成你自己的 profile 名，profile 已经在运行的要重启才生效。第一次用时对模型说「检查一下视频插件环境」，它会调 doctor，经你同意后再调 setup 装渲染依赖（约几百 MB，外加约 110 MB 的 Chrome Headless Shell）。想用仓库里还没发版的代码，可以 clone 后在上一级目录执行 dsh plugin --profile web add ./brewreel/integrations/deepseek-harness。插件还没接真实 DeepSeek 模型实测，遇到问题请开 issue。

  • brewreel_doctor 查环境，brewreel_setup 装依赖和浏览器，brewreel_catalog 列风格、行业和配色，brewreel_guide 读 skill 与各风格、行业、镜头文档，brewreel_validate 校验分镜并给改法，brewreel_render 后台出片，brewreel_verify 核对成片是否还对应当前分镜。
  • 许可提醒：插件和 skill 是 Apache-2.0，但渲染引擎 Remotion 不是开源软件，4 人及以上的营利组织需要购买 Remotion 的 Company License（见「版权与许可」和 THIRD_PARTY_LICENSES.md）；插件不改变这一点。
  • 渲染子进程不经过 dsh 的 shell 沙箱，以当前用户权限运行。
  • 配置项、安全说明和故障排查见插件的 README。

功能

三种配方

分镜里写 `meta.s

// HOW IT'S BUILT

KEY FILES

SKILL.mdREADME.md

// REPO STATS

113 stars

// SHARE

Share on XShare on LinkedIn