结论先行
- 它是什么:一个「故事层」skill。读你的项目代码 → 定创意角度和语气 → 写分镜 → 把 brief 交给 HyperFrames 渲染 → 出
brag.mp4+ 海报帧 + 分享文案。目标 15–25 秒。 - 它不是什么:不是渲染引擎,不做爆款复刻,不做长视频、教程、口播。它和前两篇的 rea-video、Hypit 不在一层(见工具地图)。
- 最值得拿走的:不是工具,而是它那套「创意法则」和「先定 hook、再定分镜、再交渲染」的分工。作者自己写得很清楚:它「保持很薄,好让它搭上 HyperFrames 的每次改进」。
- 对你(独立开发者,要做出来→卖出去):每个产品上线时出一条 20 秒视频,是它最对口的用法。成本是 agent token 加几分钟渲染,不需要生成视频的模型。
- 要留意:它依赖 HyperFrames,而 HyperFrames 的 skill 名字近期改过(issue #64);Opus 5.5 上它默认切到不依赖 HyperFrames 的
brag-slim,行为和文档里的「完整版」不同。
它的工作原理
一、分工:brag 管故事,HyperFrames 管实现
SKILL.md 把职责划得很清楚:
| 谁 | 负责 |
|---|---|
/brag | 产品角度、素材选取、分镜、语气、格式、音频选择、交付预期 |
| HyperFrames | 具体的合成结构、动画时序、运行时、lint、渲染 |
四步流程,每步都有「门」(gate):
- Inspect:读项目代码,回答 9 个问题(它是什么、给谁、卖点、最离谱的一条、视觉钩子、可展示的真实界面/流程、语气、分享文案……)。门:9 个问题都能答。
- Plan:写
brag-plan.md,含 hook、2–3 个高光、结尾笑点、视觉识别(精确色值与字体)、逐场景分镜、音频方向。门:场景时长总和 15–25 秒。 - Hand off:写 composition brief 交给 HyperFrames。门:
npx hyperframes check零错误。 - Deliver:渲染 mp4,挑最好的一帧作海报并烘进视频第 0 帧(这样各平台缩略图都是它),写
share-copy.txt。
两个细节值得注意:
- 它读的是代码,不需要线上 URL 或截图。所以颜色、字体能取精确值,界面可以直接复用组件而不是拍屏。
- 它明确跳过 HyperFrames 自带的「故事线/SPEC.md」流程,用自己的 plan + brief 取代。也就是说,它不是 HyperFrames 的套壳,而是把上游的创意环节替换掉了。
二、创意法则:真正的「方法论」
这几条写在 SKILL.md 里,与语气无关,对所有视频生效:
| 法则 | 含义 |
|---|---|
| Short | 15–25 秒,多一秒要有理由;开口说话也不延长 |
| Readable | 靠运动和剪辑提速,不靠让字一闪而过;短标签停约 0.8 秒,句子约每词 0.3 秒 |
| Specific | 要像专为这个项目做的,不是任何项目都能套 |
| Show the thing | 至少一场戏必须出现真实界面/文案/关键视觉 |
| No generic SaaS language | 「Streamline your workflow」直接禁用,用项目自己的话 |
| The hook is everything | 前 2 秒决定观众留不留,先规划它 |
| Funny earns its place | 笑点来自项目本身的荒诞,不是硬凹 |
结构也给了默认形状:Hook(2–3s)→ Reveal(2–4s)→ 2–3 个高光(5–12s)→ 结尾笑点(2–4s),并声明「是起点,不是模板」。
七种语气预设:default / polished / yc-parody / chaotic / deadpan / cinematic / app-store,各自规定场景数(例如 chaotic 6–8 场、deadpan 3–4 场)、转场和文字风格;也接受自由描述,如 --tone "fake Series A launch from 2016"。
选项:--format(横/竖/方)、--duration、--no-music、--no-sfx、--title、--voice(旁白默认关,开了用 Kokoro,单一供应商)。
三、音频:自带素材库
完整版自带音乐和音效(音乐来自 ende.app,CC BY 4.0;音效来自 Kenney),并有「cue 预设」把重点镜头对齐到节拍。issue #59 指出过它一度没附音乐许可说明,已关闭。
四、/brag-slim:同一套法则,去掉 HyperFrames
仓库最近加的 brag-slim 是一份约 9KB 的单文件 skill,README 写它是「为 Opus 5.5 重建的精简版」:没有 HyperFrames,没有打包素材,模型自己用机器上已有的工具(浏览器、编码器)做完故事、画面、声音和渲染。
和完整版相比:
/brag(完整) | /brag-slim | |
|---|---|---|
| 渲染 | HyperFrames | 模型自己搭 |
| 素材 | 自带音乐/音效库 | 无,音乐由模型合成 |
| 输入 | 项目代码 | 项目代码或网站 URL |
| 旁白 | 支持 --voice | 不支持 |
| 创意法则 | 同 | 同(多了「Every frame postable」「Make it alive」) |
在 Opus 5.5 上,/brag 会自动切到 slim,除非你写 --full 或 --voice。这很有意思:一份 9KB 的 prompt 加上更强的模型,替代了一整套依赖链,说明这类 skill 的「脚手架」会随模型变强而变薄。我不确定 slim 的出片稳定性是否和完整版相当,没找到对比。
它做不到什么
按仓库自己的文件和 issue,不是我臆测:
- 只做 15–25 秒的发布视频。 想要 2 分钟的演示、教程、应用审核录屏,它的法则反而是错的。issue #69 就是有人拿它做平台应用审核视频(需要真实录屏、地址栏、完整授权流程,2–3 分钟),指出按法则会产出一条 20 秒动画重建,会被拒,而且重建授权页会失实。提议加一步「先确认视频用途」,仍是 open。
- 不复刻别人的视频。 它只讲你自己的项目。
- 不生成真人/实拍画面。 全是 HTML 动画。
- 依赖运行环境:Node 22+、FFmpeg、HyperFrames CLI(
npx hyperframes doctor自检)。Windows 上它用符号链接做多 agent 发现,需要core.symlinks或开发者模式。 - 项目跑不起来时会降级。 issue #67 提到,Next.js App Router 之类的真实组件离开应用就渲染不了,需要用项目自己的样式表重新编译、手抄组件标记;缺编码器/无头浏览器时要先问你再装。
网上的相关讨论
我搜到的比较薄,直说:
- 没有找到 Hacker News、Reddit 或长篇实测。 能找到的是技能目录(skills.sh、skillsmp、typingmind 等)、几条 TikTok/YouTube Shorts 和几篇二手介绍。
- 一篇 2026-09-20 的介绍文(scriptxeno)读过仓库和 GitHub 数据,同样没实跑。结论:「早期、小,但真实」「窄而有差异」「值得观察,既不是爆款也不是噱头」。它提到维护者拒绝了一个约 1 万行的重写,理由是要保住「轻量灵活」的版本、避免维护两份真相来源;还指出依赖风险:HyperFrames 停滞或转向,brag 就没有独立价值。
- 一篇 2026-09-26 的个人笔记(nicolasdeville)也没实跑,计划是「给每个实验项目出 20 秒视频」,最看重的是「它补上了我觉得最难的部分:故事」,并认为这套规则「就算不用
/brag也值得抄进自己的视频 skill」。该笔记自己标明由 AI 起草。 - Nous Research 的 Hermes 把它收为 optional skill(
hermes skills install official/creative/brag),标注版本 0.4.0(上游已到 0.5.0)。Hermes 页说其安全扫描「目前拦下 HyperFrames 的五个领域 skill 中的四个」,完整路径「尚不可完整安装」,而 slim 没这个依赖。 - 另有一个托管版 letsbrag.app:README 说贴网站链接就能得 20 秒视频,「无需安装、无订阅」。我没试,也没读到它的条款或限额。
关于热度的提醒:同一个仓库,2026-09-20 那篇文章记的是约 5,954 星,今天 API 是 20,697 星;还有搜索结果把别处的数字(如 Hermes 镜像页的 25 万)混进来。星数请只当关注度。
issue 里暴露的真问题
GitHub 显示 17 个 open 项,含 PR(我列出的前 30 条里,open 的 11 条中 issue 与 PR 各占一部分)。值得读的几条:
| # | 问题 | 为什么重要 |
|---|---|---|
| #66 | 产品若展示人的数据(消息、联系人、粉丝、健康/财务),应展示真实界面+明显的占位数据,不要用库里的真实记录 | 视频是为了公开分享,这些人没同意出镜。自己用时务必留意,尤其是你的项目有演示数据时 |
| #69 | 先确认视频用途再套法则 | 见上,法则不是万能的 |
| #67 / #65 / #68 | slim 在项目不能独立运行、凭肉眼挑静帧会漏问题、竖屏文字避开平台浮层 | 都是出片质量的细节 |
| #54 | 提议加 /brag-stems:导出音轨分离、两轨混音、带时间码的字幕与提词器 | 反映用户想把成片再交给人做后期 |
| #51(已关) | 批量跑 10 个项目的经验:维护一份「每次追加教训」的 living brief;调度者看输出而不是看汇报 | 批量出片的现成做法 |
| #50(已关) | hyperframes check 可能在 0 项对比度检查下通过,oklch 色板会触发这点 | 完整版的门并非完全可靠 |
| #64(已关) | 第 3 步引用了新版 HyperFrames CLI 已移除的 skill 名 | 上游改名会打断下游,也是依赖风险的实例 |
此外 #56、#53 是安全修补:slim 把抓取到的网页内容当数据而非指令,并规定跳过 .env、密钥文件等不读。这说明「读你整个项目然后做公开视频」这个动作本身有泄密面,它的处理是写进了规则,不是技术隔离。
它和前两篇的关系
| rea-video | Hypit | HyperFrames | brag | |
|---|---|---|---|---|
| 层 | 拆解 | 复刻/混剪成片 | 渲染底座 | 创意+分镜,调用渲染底座 |
| 输入 | 别人的视频 | 参考视频+素材 | HTML | 你自己的项目 |
| 产物 | 证据链与重制计划 | 成片 | 成片 | 15–25 秒发布视频+文案 |
| 许可证 | Apache-2.0 | 修改版 Apache | Apache-2.0 | MIT |
它和 HyperFrames 的关系是「上层 skill 复用下层底座」,和 Hypit 的「大而全一体」是两种设计取向:前者薄、可换底座;后者厚、自带全流程。
你可以怎么用
- 直接用:在要上线的产品目录里让 agent 跑
/brag(Opus 5.5 会自动用 slim)。先别设语气,看默认出片,再试--tone deadpan或你自己想的描述。先--format vertical和landscape各出一次,因为投放平台不同。 - 跑之前清场:项目里有真实用户数据、内部域名、密钥时,先换成占位(见 #66);它虽然有跳过
.env的规则,但那是 prompt 约束,不是沙箱。 - 只抄方法:把「创意法则」和 Inspect 的 9 个问题抄进你自己的发布流程,即使不出视频,拿来写落地页首屏和 X 发布文案也适用(尤其是「前 2 秒」「具体而非通用」「展示真实界面」)。
- 批量:有多个项目要出片,参考 #51 的做法,让调度者验成片(探测 mp4、抽帧)而不是只读子 agent 的汇报。
- 别用它:要做教程、长演示、审核录屏、旁白讲解视频时,法则是反的,换用 HyperFrames 原生流程或直接录屏。
值得吸收的设计
- 「把创意决定写成规则」:这个仓库的核心资产是约 7 万字符的规则文档(SKILL.md 加 6 份 references)而不是代码。规则可检验(时长总和必须 15–25 秒、停留时间有公式),这点比泛泛说「要好看」强得多。
- 每步一个门:每一步结束都有一条可检查的完成判据,和你自己的长跑任务写进文件再接续的做法一致。
- 薄层复用底座:不自己造渲染器,换底座成本低;代价是被上游改名打断(#64)。
- 随模型变强而退化:slim 的存在本身是一个信号,值得在自己的 skill 里定期问一句「这条规则还需要吗」。
没覆盖到的
- 实跑出片的质量、耗时、token 成本:我没跑,仓库和二手介绍里也没有实测数字。
letsbrag.app的限额、条款、出片质量。- 完整版与 slim 的出片对比。
- 知乎、小红书、X 上的中文/英文使用反馈:搜索没有命中,不代表没有。
来源
8 条
- 仓库:latent-spaces/brag,已读 README、PRODUCT.md、
skills/brag/SKILL.md、skills/brag-slim/SKILL.md、references/step-2-plan.md、references/tones.md、scripts/check-brag-slim.mjs、issue #51 #54 #66 #67 #69 等。 - 官方站、letsbrag.app(未读内容)。
- Hermes 目录页。
- scriptxeno 介绍文(2026-09-20,未实跑)。
- nicolasdeville 笔记(2026-09-26,AI 起草,未实跑)。
- YouTube《/brag Turns Any Side Project Into a Launch Video in 20 Seconds》:页面抓取只得到标题,内容未核实,仅作线索。
- 前两篇:rea-video、工具地图。