Communitygithub.com

freudianflips/breakout-launch-videos

從網站建立品牌套件,供啟動影片使用。執行工具從讀者的網站提取品牌元素(顏色、字型、Logo、名稱、標語、文案、產品圖片),然後與讀者一同審閱預覽表,並手動修正任何錯誤的角色設定。

breakout-launch-videos 是什麼?

此技能用於自動化品牌素材萃取流程,讓 AI 代理可以從目標網站中提取完整的品牌識別元素,並產出結構化的 `brand.json` 檔案。它支援 Node.js 平台,透過 Puppeteer 無頭瀏覽器擷取網站的 CSS 變數、字型、Logo 候選、顏色調色盤、圖片及網頁截圖,並自動生成預覽圖表以供審閱。此工具特別適合在製作品牌啟動影片前,為每個品牌執行一次;當網站外觀變更時,也可重新執行。它提供詳細的審核流程,引導使用者檢查 Logo 可讀性、強調色、背景色、字型等,並支援手動修正後再標記為「已審閱」。此外,技能內建豐富的應變機制,包括處理無 Logo、深色模式、單色品牌、字型授權問題及封鎖無頭瀏覽器的網站,確保彈性與可靠性。

相容平台~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 讀取其外觀。此技能可從讀者自己的網站建立該檔案,進行檢查,然後交給 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 需要一個淺色版本:向讀者索取他們檔案,或編輯 logo-on-dark.svg 內的顏色。
  2. 強調色。 應該是大家聯想到品牌的顏色,通常是主要按鈕。evidence.json 列出 accent_candidates 及其票數。如果它選中了英雄插圖顏色或狀態顏色,請換上正確的十六進位碼。
  3. 背景色和墨水色。 陳述場景位於 ground 上,使用 ink 類型。它們必須符合網站的感覺(暖色米白、純白、淺色紙張色調)。
  4. 深色。 英雄卡片使用 dark。它看起來應該像品牌自己的深色區塊,而不是隨機的近黑色。如果網站沒有深色區塊,工具會加深強調色;檢查它是否符合預期。
  5. 字型。 顯示字型必須在圖表的英雄文字中渲染。evidence.json 中的 fonts 顯示找到哪些檔案。
  6. 名稱和標語。 標語位於組合標誌的名稱下方:2 到 8 個字,使用網站自己的詞語。

直接在 brand.json 中修正錯誤的值,重新渲染預覽,向讀者展示,然後才將 "reviewed": true 標記爲已審閱。在回覆中用一行記錄任何手動更改的內容。

每個角色在影片中的作用

角色用途
ground每個陳述場景、產品導覽地板、結尾組合標誌。
surface地面上的卡片、晶片和視窗。
ink, ink_secondary淺色背景上的英雄文字和輔助文字。
accent節制使用:每個場景一個元素(按鈕按下、開關、完成狀態)。除非簡報要求強調英雄卡片,否則永遠不要用於整個地面。
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。 工具會退回到網站圖示並告知。向讀者索取 SVG(最佳)或寬度至少 1000 px 的透明 PNG;將其放入 brand/ 並將 logo.file 指向它。
  • 深色模式網站。 mode 為 dark。頁面的背景成為 dark,並從中推導出 ground 和 ink 用於淺色陳述場景。如果品牌也想要深色陳述場景,請手動交換 ground 和 dark(以及 ink 和 dark_ink)。
  • 單色品牌。 沒有飽和顏色獲得票數,因此 accent 是主要按鈕顏色(通常是黑色),highlight 是淺灰色。詢問讀者是否有標誌性顏色;如果沒有,保持單色,讓字型和動態來承擔影片。
  • 網路字型無法下載。 某些字型廠商封鎖直接下載。在本機安裝該字型(影片會依家族名稱回退至已安裝字型)或從 Google Fonts 選取最接近的開放字型並將其檔案放入 brand/fonts/。
  • 字型授權。 網路授權不一定涵蓋影片。在影片發布前,確認顯示字型和內文字型已獲影片或動態使用授權,或使用開放(OFL)字型。
  • 讀者有品牌指南。 以他們的指南為準。手動將值輸入到 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.

相關技能