brag 是什么？

brag 是 latent-spaces 发布的开源 Agent Skill，MIT 许可证。它不是通用的视频编辑工具，也不是“文字转视频”的生成器。它的定位非常窄：把一个刚写完的项目代码，变成一条“像产品发布一样”的短视频。

它的工作方式是：你进入项目目录，对 AI 说 /brag。Skill 会扫描项目文件，理解这个项目是做什么的，然后规划一条 15–25 秒的故事板，包括场景、文字、时长、转场和音效提示。故事板确认后，它把一份聚焦的 brief 交给 Hyperframes（另一个 Agent Skill 体系），由 Hyperframes 负责具体的合成、动画时序和渲染。最终输出到 brag-output/：一份计划文档、视频文件、最佳帧海报和分享文案。

它还有一个轻量版本 brag-slim，面向 Claude Opus 5.5，去掉了固定工具链依赖，模型用当前环境里已安装的工具自行构建视频。

brag 的主要功能

项目扫描与故事板规划。读取项目目录，回答一份 9 项规划问题（项目是什么、给谁看、哪个功能最值得展示等），然后写出 brag-plan.md，包含逐拍故事板：场景、文字、时间、转场和音效提示。

交给 Hyperframes 渲染。brag 负责“故事”——产品角度、语气、展示哪些瞬间。Hyperframes 负责“工程”——合成结构、精确动画时序、渲染管线、lint 检查。分工明确，各司其职。

七种语气预设。默认是“Playful, clean, postable”（轻松、干净、适合发帖）。还可以选 polished（认真优雅）、yc-parody（死板创业腔，适合恶搞）、chaotic（快节奏、吵闹）、deadpan（冷淡克制）、cinematic（电影感）、app-store（应用商店风格）。也支持自由描述语气，比如 --tone "fake Series A launch from 2016"。

配音与音乐。默认无配音。加 --voice 启用旁白，使用 Kokoro TTS 通过 Hyperframes 生成。视频自带配乐和音效，来源是 ende.app 和 Kenney 的免费素材。

brag 的核心特色

“读代码，不读截图”。brag 直接从项目目录读取代码来理解产品，不需要你提供线上 URL 或截图。这意味着即使是本地开发中的、还没部署的项目，也能生成视频。

15–25 秒的硬约束。官方创意法则明确规定：15–25 秒，没有理由不加一秒。节奏靠动效和剪辑保持，不靠堆砌文字或快速闪烁。这条纪律让输出天然适合社交媒体分享。

“brag 管故事，Hyperframes 管工程”。这是整个 Skill 的架构核心。brag 不陷入渲染细节，Hyperframes 不操心产品叙事。两者的边界清晰，输出质量稳定。

视频自带海报帧。渲染完成后，Skill 会从视频中挑选最佳帧作为海报，并把它烘焙为视频的第 0 帧，让视频在任何平台上默认显示这张缩略图，而不是黑屏或随机帧。

brag 可以用来做什么？

给刚做完的项目生成一条发布视频。你花了一个周末写了一个工具或应用，想发 Twitter/X 或 Product Hunt，但不想花时间剪视频。在项目根目录跑 /brag，几分钟后拿到一条带音乐、动效和分享文案的 MP4。

给 README 或落地页配视频。生成的 brag.mp4 可以直接嵌入 README 或落地页的 hero 区域。官方仓库自己的循环视频就是用 brag 生成的。

用不同语气做 A/B 测试。同一项目可以用 --tone polished 和 --tone chaotic 各生成一条，看哪种风格更适合你的受众。

不适合的场景：需要精细剪辑的长视频、需要真人出镜或实拍素材的视频、以及需要精确控制每一帧内容的专业制作。

brag 适合哪些人？

  • 独立开发者和 Indie Hacker：做完项目想快速生成一条能发社交媒体的视频，不想打开剪辑软件。
  • 用 Claude Code 或 Cursor 的开发者：已经在 AI 编码助手里工作，顺手一条命令就能拿到发布素材。
  • 需要频繁做产品演示的团队：每次发版或新增功能，用 brag 快速生成一条短演示。
  • 对视频质量有基本要求但不想学剪辑的人：brag 的输出不是专业级，但干净、可分享、有设计感。

不太适合：需要专业视频制作的人、项目没有可读代码的场景（比如纯设计项目）、以及不希望视频内容由 AI 自动规划的人。

brag 如何安装？

方式一：Claude Code 插件市场（推荐）

/plugin marketplace add latent-spaces/brag
/plugin install brag@brag

然后在任意项目内运行 /brag。

方式二：通过 skills CLI（Cursor、Codex、Copilot、Gemini CLI、opencode 等）

npx skills add https://github.com/latent-spaces/brag --skill brag

加 -g 全局安装，不加则只在当前项目可用。

方式三：手动复制（无安装器时）

rsync -a --exclude '.DS_Store' skills/brag/ ~/.claude/skills/brag/

复制后重启 Claude Code。

前置条件：Node.js 22+、FFmpeg 在 PATH 中、Hyperframes CLI 可用（运行 npx hyperframes doctor 验证）。

brag 怎么使用？

基本用法：

let's /brag

在项目根目录对 Agent 说这句话，或者直接输入 /brag。

控制语气：

/brag --tone "fake Series A launch from 2016"

七种预设：default、polished、yc-parody、chaotic、deadpan、cinematic、app-store。

启用配音：

/brag --voice

默认无配音。开启后使用 Kokoro TTS 生成旁白。

输出内容：运行完成后，项目目录下会出现 brag-output/ 文件夹，包含 brag-plan.md（故事板）、brag.mp4（视频）、brag.jpg（海报帧）和 share-copy.txt（分享文案）。

brag 使用技巧

第一次跑先不加配音。默认无配音是有理由的：配音会显著增加渲染复杂度和时间。先确认故事板和视觉效果满意，再加 --voice 重新生成。

用语气预设探索不同风格。同一个项目用 polished 和 yc-parody 各跑一次，看哪个更适合你的目标受众。语气改变的不只是旁白（如果有），还包括节奏、字体风格和转场方式。

检查故事板再交给渲染。brag 生成 brag-plan.md 后会等待确认（或按流程继续）。如果你对“展示哪个功能”不满意，在这个阶段调整比视频渲染完再改便宜得多。

注意 Windows 符号链接问题。如果你在 Windows 上通过 Git 克隆仓库，需要 git config core.symlinks true 并开启开发者模式，否则符号链接可能失效。最简单的办法是手动复制 skills/brag/ 到 Agent 的技能目录。

brag 收费吗？

Skill 本身免费且开源。brag 采用 MIT 许可证，代码和素材（配乐、音效）在仓库中公开。你只需要为使用的 AI 编码助手（Claude Code、Cursor 等）支付订阅费用。

但生成视频会消耗 AI 调用。一位用户报告用 brag 为项目生成发布视频，成本约 $3–4（取决于模型和项目复杂度）。这不是 Skill 收费，而是底层模型的 API 消耗。

brag 的优点与缺点

维度 优点 缺点
速度与便捷 一条命令从项目代码到 MP4，不需要截图、录屏或剪辑 依赖 Node.js、FFmpeg 和 Hyperframes，环境配置有一定门槛
输出质量 15–25 秒的硬约束 + 七种语气预设，输出干净、可分享 不是专业级视频，精细控制有限
架构分工 brag 管故事、Hyperframes 管工程，边界清晰 两个 Skill 体系的依赖，任一环节出问题都可能阻塞
成本 Skill 免费开源，MIT 许可 AI 调用可能产生 $3–4 量级的费用（因项目和模型而异）
兼容性 支持 Claude Code、Cursor、Codex、Gemini CLI、opencode 等 Windows 符号链接需要额外配置，否则需手动复制

brag 与同类工具对比

vs 手动录屏 + 剪辑。录屏需要你操作产品、控制节奏、事后剪辑。brag 直接从代码理解项目，自动规划故事板，几分钟出片。代价是你放弃了逐帧控制权。

vs 通用 AI 视频生成器（Runway、Pika）。这些工具生成的是像素，从文字提示出发，不读你的项目代码。brag 生成的是基于你实际项目结构和功能的视频，不是泛泛的“科技感”画面。

vs 其他“项目到视频”的 Skill。brag 的独特之处在于它不依赖线上 URL 或截图，直接读代码。以及它的“brag 管故事、Hyperframes 管工程”架构，让渲染质量和叙事质量可以独立控制。

brag 常见问题 FAQ

Q：brag 需要我的项目已经部署上线吗？
不需要。brag 直接读取项目代码目录来理解产品，本地开发中的项目也能生成视频。它不需要线上 URL 或截图。

Q：生成的视频有多长？
官方创意法则规定 15–25 秒。故事板中所有场景时长加起来必须落在这个范围内。

Q：可以控制视频的语气吗？
可以。七种预设：default、polished、yc-parody、chaotic、deadpan、cinematic、app-store。也支持自由描述，比如 --tone "fake Series A launch from 2016"。

Q：有配音吗？
默认无配音。加 --voice 启用 Kokoro TTS 旁白。

Q：brag 和 brag-slim 有什么区别？
brag-slim 是轻量版本，面向 Claude Opus 5.5，不依赖固定工具链，模型用当前环境已有的工具构建视频。适合不想配置 Hyperframes 完整工具链的场景。

Q：生成视频要花多少钱？
Skill 免费。实际成本来自 AI 模型的 API 调用。一位用户报告约 $3–4（取决于模型和项目复杂度）。

brag 综合评价

brag 解决的是一个非常具体的摩擦：项目写完了，但“把它展示出去”这件事需要额外的心智切换和工具链。录屏、剪辑、找配乐、写文案——每一步都是打断。

它的设计很克制：15–25 秒，七种语气，一条命令。它不追求“专业视频制作”，而是追求“足够好、足够快、能发出去”。从代码读项目这个选择也很聪明——省掉了截图和 URL 的准备工作，让整个流程从“打开项目目录”开始，而不是“准备素材”开始。

它的门槛在于环境。Node.js 22+、FFmpeg、Hyperframes CLI——这些对于已经在做前端或全栈开发的用户不算高，但对于只是想“生成个视频”的人，可能需要一些配置时间。Windows 用户还需要额外处理符号链接。

对于独立开发者、Indie Hacker、或者任何经常需要在社交媒体上展示自己项目的人，brag 值得花十分钟安装配置。它不会让你的视频变得“专业”，但会让你的项目有一条拿得出手的发布视频，而成本只是一条命令和几美元。