Communitygithub.com

freudianflips/breakout-launch-videos

从网站提取品牌元素(颜色、字体、Logo、名称、标语、文案、产品图片),生成启动视频需要的品牌套件。运行于 Reader 的网站上,通过 tools/brand-from-url.mjs 提取品牌信息,然后与 Reader 一起检查预览表,手动修正任何错误。适用于“从网站获取品牌”、“品牌套件”、“提取品牌特征”、“获取我们的颜色和字体”、“使用我们的Logo”或为新品首次制作启动视频之前使用。

breakout-launch-videos 是什么?

该技能专为生成 AI 代理启动视频所需的品牌套件而设计。它通过读取目标网站,自动提取品牌颜色、字体、Logo、名称、标语、文案和产品图片等核心元素,并将这些数据整合到 `brand/brand.json` 文件中。随后,它会生成一张预览表(preview.png),帮助用户快速验证各项提取结果是否准确。如果发现错误(例如 Logo 在深色背景下不可见、Accent 颜色选错、字体不匹配等),用户可以手动编辑 `brand.json` 并重新生成预览,直至满意。该技能支持多种技术平台,包括 Claude Code、Cursor、Codex 等,通过 Node.js 脚本 `tools/brand-from-url.mjs` 实现自动化提取。它还处理了 Cookie 横幅、懒加载内容、字体下载等复杂情况,并提供了在网站无法直接访问时使用本地 HTML 文件进行提取的备用方案。最终生成的品牌套件将直接交付给 `launch-film` 技能用于制作启动视频,确保视频视觉风格与网站一致。

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

在你喜欢的 AI 中提问

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

文档

启动视频品牌套件

每个启动视频的外观都从 brand/brand.json 文件中读取。本技能可从 Reader 的网站生成该文件,进行检查,并交付给 launch-film。每个品牌运行一次,当网站外观发生变化时再次运行。

1. 提取

npm install                                   # 一次性安装:puppeteer 及其 Chrome
node tools/brand-from-url.mjs https://your-site.com --out brand

它会在 1920x1080 分辨率下打开页面,关闭 Cookie 横幅,滚动一次以便懒加载内容载入,然后写入:

文件作用
brand.json视频使用的角色。这是视频唯一读取的文件。
evidence.json每个角色是如何决定的依据:计算样式、CSS 颜色变量、像素直方图、按钮和链接颜色、字体、每个Logo备选及其得分和理由。
logo.svg 或 logo.png适用于浅色背景的Logo。logo-on-dark.* 用于深色背景,mark.svg 当可以独立出仅图标标记时。
fonts/页面实际加载的显示字体和正文字体文件(如果页面未提供,Google Fonts 会从 css2 API 获取)。
screens/hero.png, screens/full.png第一个视口和完整页面(限制在 6000 px)。
images/最大的内容图片,通常是产品截图。
preview.png一张汇总表:Logo 在浅色和深色背景上、每个颜色角色、带有高亮的显示字体、深色英雄卡片、强调按钮。

标志:--no-fonts 跳过字体文件,--max-images 0 跳过图片。本地页面也可以(node tools/brand-from-url.mjs ./site/index.html)。手动编辑 brand.json 后,用 node tools/brand-from-url.mjs --preview --out brand 重新渲染预览表。

2. 复查(切勿跳过)

并排阅读 preview.png 和 screens/hero.png。这些角色是基于启发式规则得出的;预览表能在 10 秒内显示其判断是否准确。按以下顺序检查:

  1. Logo 在浅色和深色背景上。两者都必须清晰可读。在深色背景上消失的Logo需要浅色版本:向 Reader 索取其文件,或修改 logo-on-dark.svg 中的颜色。
  2. 强调色。它应该是人们将该品牌关联起来的颜色,通常是主要按钮的颜色。evidence.json 列出了带有投票数的 accent_candidates。如果工具选择了英雄插图颜色或状态颜色,则替换为正确的十六进制值。
  3. 底色和文字色。叙事场景使用 ground 作为底色,ink 作为文字色。它们必须与网站的感觉相匹配(暖色米白、纯白、有色纸张)。
  4. 深色。英雄卡片使用 dark。它应该看起来像品牌自己的深色板块,而不是随机的接近黑色。如果网站没有深色板块,工具会加深强调色;检查其效果是否与预期一致。
  5. 字体。显示字体必须在预览表的英雄文本中正确渲染。evidence.json 中的 fonts 部分显示找到了哪些文件。
  6. 名称和标语。标语位于锁定画面中的名称下方:2 到 8 个单词,使用网站自身的表述。

直接在 brand.json 中修正错误值,重新渲染预览,向 Reader 展示,然后才将 "reviewed": true 设置为真。在回复中用一行记录您手动更改的任何内容。

每个角色在视频中的作用

角色用途
ground每个叙事场景、产品展示的地面、结尾锁定画面。
surface在底色上的卡片、标签和窗口。
ink, ink_secondary浅色背景上的英雄文字和辅助文字。
accent谨慎使用:每个场景使用 1 个元素(按钮按下、切换、完成状态)。除非简报要求英雄卡片使用强调色,否则不作为整个底色。
accent_ink强调色上的文本。
dark, dark_ink硬切换的英雄卡片、深色时刻。
accent_on_dark深色卡片上的关键词(强调色被变浅直到可读;对于单色品牌使用 dark_ink)。
highlight每行 1 或 2 个关键词后的柔和标记,切勿超过。
success, danger勾选、完成状态、罕见的失败词汇。
fonts.display英雄文字(权重和字距来自网站的 h1)。
fonts.body辅助行、UI 标签。
logo, name, tagline, domain剪辑上的名称节拍和结尾锁定画面。
copy脚本的词汇。视频使用网站的语言;launch-story 从 copy.h1、copy.subhead、copy.h2 和 copy.features 开始。
images备选产品截图。来自读者的真实产品截图或录制内容优于任何抓取的图片。

备用方案

  • 未找到Logo。工具会回退到网站图标并告知。向 Reader 索取 SVG(最佳)或宽度至少 1000 px 的透明 PNG;将其放入 brand/ 并将 logo.file 指向它。
  • 深色模式网站。mode 为 dark。页面背景变为 dark,而 ground 和 ink 从深色模式推导出用于浅色叙事场景。如果品牌也想要深色叙事场景,手动交换 ground 和 dark(以及 ink 和 dark_ink)。
  • 单色品牌。没有饱和颜色获得投票,因此 accent 是主要按钮颜色(通常是黑色),而 highlight 是浅灰色。询问 Reader 是否有品牌标志性颜色;如果没有,保持单色,让字体和动画承载视频。
  • 网络字体无法下载。某些字体厂商阻止直接下载。在本地安装字体(视频按家族名称回退到已安装字体)或从 Google Fonts 选择最接近的开放字体,并将其文件放入 brand/fonts/。
  • 字体许可。网络许可证通常不涵盖视频。在视频发布前,确认显示字体和正文字体已获得视频或动态使用许可,或使用开放(OFL)字体。
  • Reader 有品牌指南。以他们的指南为准。手动将其值输入 brand.json(保持相同键),将Logo文件放入 brand/,重新渲染预览并标记为已复查。
  • 网站阻止无头浏览器。从普通浏览器保存页面(文件,另存为,完整)并在此保存的 HTML 文件上运行工具。

交付

launch-film 在构建时读取 brand/brand.json。当 "reviewed": false 时构建的视频是草稿;展示时请标明。

Individual skills in this repo

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

freudianflips/breakout-launch-videos

Make or change a product launch film in your own brand. A film is a hook (the story before the cut) on a shared body (the name punching in, hero words cut on the voice, your product at close range, the logo lockup in near silence), built in HyperFrames from brand/brand.json and film/film.json. Holds the core, the template workflow (build, render and mix 1 hook or all of them), the generation recipes, the checks and the lessons. Use for "launch video", "launch film", "product video", "promo", "reveal", "announcement video", "new hook", "change the body", "render all launch videos".

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.

相关技能