Communitygithub.com

freudianflips/breakout-launch-videos

创建或修改属于您自己品牌的产品发布视频。一个短片包含一个钩子(剪辑前的故事)和一个共享主体(品牌名称出现、关键文字与配音同步、产品特写、最后在近乎静音中展示标志),使用 HyperFrames 基于 brand/brand.json 和 film/film.json 构建。它包含了核心、模板工作流(构建、渲染和混合一个或所有钩子)、生成配方、检查清单和经验教训。适用于“发布视频”、“发布短片”、“产品视频”、“宣传片”、“揭晓预告”、“公告视频”、“新钩子”、“修改主体”、“渲染所有发布视频”。

breakout-launch-videos 是什么?

此技能提供一个完整的产品发布视频制作工作流,遵循类似 Apple 和 Lovable 的发布语法。视频结构分为两部分:一个可自定义的“钩子”(剪辑前 4-18 秒的故事)和一个标准化的“主体”(展示品牌、产品特写、功能总结并以标志结束)。品牌信息(颜色、字体、标志)从 `brand/brand.json` 文件读取,确保一致性和可复用性。该技能以一种模板化、规则驱动的方式运作,允许用户通过创建包含 `hook.json` 文件的文件夹来制作新钩子,或通过修改 `film/film.json` 来更改所有视频的共享主体。其工作流包括严格的检查清单,涵盖文字准确性(通过语音转写验证)、响度标准(-14 LUFS)、口型同步(通过强制对齐)和风格一致性,从而减少迭代次数。该技能支持生成或自定义镜头,并附有 `launch-brand`、`launch-story`、`launch-voice`、`launch-review` 等子技能,作为详细的工具手册。通过严格遵循“先看效果再构建”的理念和每次只修改一个变量的规则,该技能旨在减少浪费并确保高质量的输出。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/freudianflips/breakout-launch-videos/tree/HEAD/skills/launch-film

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

发布短片

此处的每个发布短片都是一个钩子加上主体。钩子是剪辑前的故事(4 到 18 秒,不限创意)。在音乐的鼓点落下时,画面切到您的品牌,主体部分命名产品、逐节特写展示、将功能归结为一个理念,并在近乎静音的状态下以您的标志结束。主体是所有钩子共享的模板,因此一个新钩子只需要 1 个文件夹和 1 个 JSON 文件,而对主体的修改会影响所有短片。

工作项目位于 film/ 目录下。film/film.json 是主体(脚本行和节拍),film/hooks/<name>/hook.json 是每个钩子,brand/brand.json 是您的品牌。

从这里开始

  1. **品牌。**阅读 brand/brand.json。如果文件缺失、仍是示例品牌或标记为 "reviewed": false,请先运行 launch-brand 技能(它会将网站转化为品牌套件和预览表)。短片中的每种颜色、字体和标志均来自该文件,绝不依赖记忆。
  2. **品牌核心。**阅读 references/brand-core.md:了解每个品牌角色如何映射到短片中,以及在品牌信息不足时的默认值。
  3. **故事。**新短片从 launch-story 开始(简报、故事脊梁、脚本、节拍表)。在现有主体上创建新钩子可以从下面的“制作一个新钩子”开始。
  4. **经验教训。**在制作第一个画面之前浏览 references/lessons.md。每一行都曾是一次代价高昂的迭代。

核心(保持不变)

  • **格式:**16:9,1920x1080,30 fps,包含主体时长约 30 到 60 秒。画面由 HyperFrames 静默渲染,声音由技能工具链构建并混入,母版响度为 -14 LUFS 集成且峰值 -1 dBTP。
  • **外观:**来源于 brand/brand.json。陈述场景使用品牌 ground,标题使用 ink 并搭配 1 或 2 个 highlight 关键字,深色卡片使用 dark,accent 用于背景和每个镜头中最重要的一个元素,不用于长段文字。显示字体来自 fonts.display。标志与您网站上的显示一致。
  • **语法:**Apple 和 Lovable 发布语法。全帧关键文字在配音处硬切进入(第一个字从 2.4 倍大小带模糊效果进入,其余字从 1.3 倍大小进入),背景在硬切时变换,一个对象演变为下一个(潜入、坍缩、变形),真实产品 UI 特写,快中有缓,结尾静默定格。
  • **配音:**整部短片使用同一名旁白。每一行新文字都用该语音录制。文字落在旁白所说的词语上,通过强制对齐确定时间。
  • **音乐:**1 首曲目,放置使其重拍(鼓点下降)无论钩子长度如何都落在剪辑点上,在其小节网格上循环至结尾,并在标志下方渐弱。音效来自 1 个调色板:合成的锻造声或您生成的套件。
  • **素材:**生成或您自己的。虚构人物,不得使用名人或相似者,不得使用真实电影或演员,不得出现第三方品牌(除非用于命名集成)。提示词与素材一起保存作为来源证明(docs/rights.md)。
  • **文字:**产品自有。信息文字来自您的实时网站(brand.json copy);所有者的文案原样使用。每个数字必须真实且可验证。

开放内容

其他一切均为每部短片的自主选择:钩子的故事、外观、长度、其自有音效,以及是否在钩子中命名产品。选择最能服务创意的内容,并在全部构建之前展示外观。只有在被要求时才修改主体,然后在模板或 film.json 中修改,绝不在单个钩子中修改。

制作一个新钩子

  1. **创意和文案。**用所有者的话语写下创意。原样保留其文字。
  2. **先展示外观。**在任何付费视频工作之前提供 3 到 5 个关键帧或一个故事板页面。画面评判很快;在外观错误的基础上进行完整构建会浪费一天时间。
  3. **画面。**仅文字(免费:设置 "video": null 加上一个 ground)、您自己的素材或生成的素材(references/generation.md)。声明每个视频工作的成本并等待确认。检查生成的面孔是否与任何名人相似。
  4. 钩子文件夹。film/hooks/<name>/ 包含画面、配音行和 hook.json(模式见 references/hooks.md)。长度超过约 4 秒的钩子需自带音乐背景,否则在鼓点下降前保持静音。
  5. **构建、渲染、混合。**在 film/ 目录下运行:./render.sh <name>(构建、HyperFrames 从 index-<name>.html 渲染、音频)。母版位于 film/renders/。
  6. 检查(见下文),然后连同问题列表一同展示,并在笔记中记录结果。

修改主体

主体的节拍、其字段以及绘制它们的代码见 references/body.md。进行任何修改时:

  1. 修改 film/film.json(文字行、节拍、词语、焦点矩形)或模板 film/templates/body.html,绝不修改生成的 film/compositions/*.html。
  2. 新增或修改的文字行:用旁白的声音录制,重新运行语音预处理,使每个词语重新对齐(skills/launch-voice/scripts/prep_lines.py),提示词跟随文字。
  3. 对修改的片段截取快照,在渲染前查看(references/hyperframes-notes.md)。
  4. ./render.sh 重建、渲染并混合每个钩子(每部短片几分钟)。

在任何人看到之前的检查

  • **文字:**Whisper 逐字读取验证(whisper-cli -m models/ggml-small.en.bin 或更大模型;基础模型会误听产品名称)。
  • **响度:**集成响度 -14.0 LUFS,真峰值不超过 -1.0 dBTP(ffmpeg -af ebur128=peak=true)。skills/launch-review/scripts/review.py 测量两者。
  • **同步:**每个关键文字和关键时刻与其口语词语的时间误差在约 0.1 秒内。
  • **画面:**每个新节拍的联系表(review.py 生成 filmstrip.jpg 和 contact.jpg),然后执行 launch-review 视觉检查清单。
  • 版权:docs/rights.md。
  • **品味属于所有者:**通过检查清单并不代表短片就好。询问哪里感觉不对,而不是猜测,并且每次迭代只修改一个变量。

会导致一次迭代的规则

  • 绝不用 whisper 猜测词语的时间。使用 skills/launch-voice/scripts/force_align.py;whisper 可能使关键词语延迟 0.3 秒,观众会感觉“节拍不对”。
  • 不通过旁白录制的新文字行,即使很清晰也是一种退步。使用相同的语音和设置重新录制,或从旁白自己的文字行克隆。
  • UI 动画已经说明的内容不再添加文字卡片。不要有单调拉伸超过几秒:拉近、增加颜色、改变背景。
  • 使用绘制或矢量替代素材会显得廉价,而看起来不真实的逼真人物更糟。当逼真度失败时,采用风格化(3D 动画)而不是更便宜的选择。
  • 每个钩子单独构建和渲染(index-<hook>.html),这样并行处理 2 个钩子不会覆盖彼此的渲染。

文件存放位置

内容位置
您的品牌套件(颜色、字体、标志、文案、截图、预览)brand/(brand.json,preview.png)
主体:文字行和节拍film/film.json
钩子film/hooks/<name>/hook.json
模板、构建、音频、批量渲染film/templates/body.html,film/build.py,film/audio.py,film/render.sh
配音音轨和对齐文字film/vo/body/(line-<id>.wav,lines.json)
音乐音轨film/score/
渲染输出film/renders/
网站到品牌套件tools/brand-from-url.mjs,技能 launch-brand
工具手册(故事、配音、配乐、音效、混音、审查、世界、运动)skills/launch-*/
设置、成本、版权docs/setup.md,docs/costs.md,docs/rights.md

阶段技能

它们是此技能下的工具手册。如果与本页冲突,以本页为准。

技能用途
launch-brand网站到 brand/brand.json、标志、字体、截图、预览表
launch-story简报、故事脊梁、脚本、节拍表(基于小节网格)、故事板、参考研究
launch-voice选角、每行一次录制、适配文字行、强制对齐、草稿配音
launch-score音乐适配行动地图、重拍对齐剪辑点、草稿背景音乐
launch-soundSFX 调色板、事件地图、提示表、生成的音效套件
launch-mix总线、闪避、标志淡出、-14 LUFS 母版、混流
launch-review测量渲染输出或参考短片、视觉检查清单、问题列表、评分卡
launch-world背景、底板、Blender 玻璃、3D 镜头、着色器层
launch-motion缓动标记、连续性、相机、文字、光标、招牌动作、HyperFrames 块

参考资料

  • references/brand-core.md:品牌角色到短片元素的映射,以及品牌信息不足时的默认值。
  • references/body.md:film.json、节拍类型、时间、命令、如何修改节拍。
  • references/hooks.md:hook.json、音乐背景规则、钩子样式及其制作方法。
  • references/generation.md:Higgsfield 模型、成本以及有效的配方,加上免费的后备方案。
  • references/lessons.md:真实发布短片中已批准和已拒绝的模式。
  • references/hyperframes-notes.md:模板所依赖的 HyperFrames 约定。

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

freudianflips/breakout-launch-videos

Build the brand kit a launch film uses from a website. Runs tools/brand-from-url.mjs on the reader's site to extract branding (colours, fonts, logo, name, tagline, copy, product images), then reviews the preview sheet with the reader and fixes any wrong role by hand. Use for "brand from website", "brand kit", "extract branding", "get our colours and fonts", "use our logo", or before the first launch film for a new brand.

freudianflips/breakout-launch-videos

Tool manual under launch-film (mixdown.py for buses, ducking, loudness and the brickwall). Mix and master the audio of a launch film. Music, SFX and voice-over on separate buses, the bed ducked by the voice's real envelope with a presence carve, the music dropped out for the logo, glue compression, a true-peak-safe limiter, -14 LUFS and -1 dBTP, then laid onto the rendered picture. Use after the score, the sound effects and the voice exist, for "mix", "master", "loudness", "LUFS", "ducking", "mux the audio".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the motion language for launch films built in HyperFrames). Ease tokens, camera doctrine, continuity at every cut, type and cursor craft, and brand-neutral signature moves (logo build, world pass, branch and pulse, waterfall fill, identity morph, macro pull-back, rise) that replace HyperFrames' stock look. Says which HyperFrames blueprints and transitions to keep, transform or avoid. Use whenever a launch film's picture is designed or animated, for "animation", "motion design", "transitions", "camera move", "make it feel like Apple", "less template".

freudianflips/breakout-launch-videos

Tool manual under launch-film (measuring a render and studying a reference film). Review a rendered launch film like a demanding creative director, then drive the v1 to v2 loop. Measures rhythm, static runs, cuts against the beat grid, loudness, true peak and voice pace with a script, then applies an eye checklist for continuity at every cut, legibility, brand, real UI, claims and differentiation. Writes a gap list and a scorecard; nothing ships on numbers alone. Use on every render, and on a reference film to learn from it, for "review the video", "check the film", "what is wrong with this cut", "study this reference".

freudianflips/breakout-launch-videos

Tool manual under launch-film (music fitted to the edit with Higgsfield Sonilo, ACE-Step locally, or the free scratch bed). Score a launch film with music whose sections are the film's acts. Each take is measured for tempo and section energy, stretched onto the film's BPM and offset so its drop lands on the cut. Use after the storyboard's beat sheet exists, for "music", "score", "soundtrack", "background track", "the drop", "beat grid".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the sound palette, the event map, the cue sheet and generated sound kits). Design the sound effects of a launch film. Builds an event map from the storyboard, the voice-over word timings and the rendered timeline, voices every event from 1 consistent palette (the free synthesised, key-locked forge, or real glass, felt, wood, marimba, clicks and air generated on Higgsfield and pitched into the film's key), and renders 1 SFX stem in a shared acoustic space. Use once picture timing and the score are fixed, for "sound effects", "SFX", "sound design", "UI sounds", "sonic logo".

freudianflips/breakout-launch-videos

Tool manual under launch-film (the brief, the story spine, the script, the beat sheet and reference studies). Turn a launch brief into a launch film's story in your own brand, with the one message, the narrative spine, the voice-over script at the right length, a beat sheet on the music's bar grid and a STORYBOARD.md where every shot names its continuity in and out, its signature move and its sound. Includes the reference study and the logo-swap differentiation test. Use first, before voice, score or motion, for "launch video script", "storyboard", "brief", "what should the launch film say", "study this reference video".

freudianflips/breakout-launch-videos

Tool manual under launch-film (voice casting, one take per line, fitting lines, stitching, forced alignment, the vintage chain, the local clone and the free scratch voice). Produce the voice-over of a launch film. Casting across every Higgsfield preset voice, one file per script line fitted into its frame, pace and length rules, word-level timestamps by forced alignment so every key word lands on its visual, and fixes for lines that run long. Use after launch-story has an approved script and before picture timing is locked, for "voice-over", "narrator", "cast a voice", "record the lines", "align the words", "scratch voice".

freudianflips/breakout-launch-videos

Tool manual under launch-film (backgrounds, plates, Blender glass and 3D shots, shader layers). Build the world a launch film lives in, in your own brand, with generated background plates (cost-gated), Blender for real 3D glass objects and camera moves rendered as alpha layers, WebGL shader layers for atmosphere, and the layer order, depth of field and grade that keep UI legible over living backgrounds. Use when a storyboard needs backgrounds, 3D or atmosphere, for "background", "plate", "3D object", "glass", "Blender", "shader", "atmosphere"; motion of the UI itself is launch-motion.

相关技能