Communitygithub.com

yazzang-homelab/motion-studio

品牌資產製作階段,用於產品宣傳影片:從網址擷取真實截圖、標誌、顏色和字型,絕不重新繪製UI;品牌故事節奏;語音與吉祥物。用於獲取或修復品牌資產。

motion-studio 是什麼?

Motion Studio 是一個專門用於產品宣傳影片中「品牌資產階段」的技能。它能自動從產品 URL 擷取真實的螢幕截圖、標誌、品牌色、字型以及文案,確保影片完全基於用戶真實產品,而非重新繪製。此技能支援 Claude Code、Cursor 或 Codex 等平台的 CLI 指令,透過專案初始化、資產擷取腳本與元件化處理,將原始截圖轉換為可動畫化的 UI 零件。它還提供音樂節奏檢測、故事節拍規劃以及可選的語音與吉祥物功能,讓整個影片製作流程既專業又高效。

相容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/yazzang-homelab/motion-studio/tree/HEAD/skills/product-reel

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

產品捲軸(課程步驟 04,等級 L2)

將工作室瞄準用戶實際銷售的產品。展示影片的能量保持不變;內容則變成他們的:真實截圖、真實標誌、真實顏色與字型、真實文案、一個真實數字,以及音樂與動作同步。品牌階段之後的所有內容都執行標準的動態捲軸流程。

請求引數(可為空),僅顯示一次;後續部分將提到「上述請求」:

範圍:當用戶僅希望擷取或修復資產時,或者您從 motion-reel 的品牌階段來到這裡,請執行第 2 和第 3 部分(以及第 4 部分如有要求),進行報告,然後停止。對於全新的影片,請遵循每個部分;第 5 至第 8 部分將交由 motion-reel 流程處理。

此模式的來源

  • Tony Dinh (@tdinh_me) 報告說,一個 TypingMind 的展示影片在不到 30 分鐘內完成,而一年前類似的影片花費他超過 1,000 美元。他的提示是展示影片的一行指令加上四行簡短的方向:介紹產品 URL;使用實際的產品截圖、標誌和資產;影片必須有音樂且動作必須與之匹配;使其成為真正的專業製作,而非演示或原型。他說 Claude 自行收集了品牌資產。
  • 他的後續要求將螢幕截圖分解為元件和圖示,以便它們可以移動,而不是顯示原始截圖,並使動作更加豐富。這就是下面的元件規則。
  • 他的提示以「再試一次,ultracode。」結束。在當前的 Claude Code 中,ultracode 是一個關鍵字,會讓 Claude 為任務編寫多代理工作流程。它是否驅動了他的結果並未記錄;請勿將其作為品質開關展示。
  • Rob Hallam (@robj3d3) 在同一個 Claude Code 聊天中為他的產品製作了第二個展示影片,與第一個相同。課程推測引擎被重複使用;因此每個品牌只使用一個會話和一個專案。
  • 一個反例:@mablesjoseph 要求從一個資產資料夾中用一行指令製作一個「時尚有力的」宣傳片,結果是「不夠好,無法分享」。方向比資產本身更重要。

1. 輸入

在一個 AskUserQuestion 輪次中詢問上述請求未涵蓋的內容:

輸入預設值規則
產品 URL 與名稱必要用戶自己的產品,或他們有權推廣的產品
時長20 秒5 個故事節拍,每個 2 到 4 秒
格式先 9x16,然後 1x1,16x9相同時間軸,重新構圖
CTA詢問螢幕上的確切文字
一個證明數字詢問必須來自用戶或其網站;絕不虛構
音樂合成,120 BPM提供的曲目需要此用途的授權
語音 / 吉祥物無語音需要在 .env 中設定 ELEVENLABS_API_KEY
參考外觀無可選,透過 /motion-studio:reference-style

2. 專案

每個品牌一個專案資料夾(理想情況下是一個會話)。如果沒有 studio.json:

node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <brand-slug>-reel --title "<Product> launch" --duration 20 --brand-url <URL> --install

僅技能安裝:${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs。然後執行 npm run doctor。

3. 擷取品牌

從專案根目錄執行擷取腳本(或簡要地 motion-studio:asset-scout,帶有此確切命令和專案路徑):

node "${CLAUDE_SKILL_DIR}/scripts/capture.mjs" <URL> --root <project> --full-page [--selector "<css>"]... [--dismiss-banners]
標誌用途
--viewports desktop,mobile預設;tablet 也可用
--full-page高解析度截圖,用於裁剪部分
--selector "<css>"裁剪特定產品部分(可重複):英雄區、定價卡、儀表板面板
--dismiss-banners在丟棄式瀏覽器中點擊明顯的 Cookie 或同意按鈕(接受、同意、允許,支援英文、韓文、日文、中文、德文、法文或西班牙文;僅在橫幅或對話框內的 OK 或關閉等弱標籤才計算在內)。Manifest 中會記錄點擊了哪個按鈕,或沒有匹配項
--apply-brand將名稱、URL 和建議的顏色寫入 studio.json
--dark擷取深色主題
--no-fonts跳過字型下載(預設:儲存頁面載入的網頁字型)
--allow-private允許頁面存取迴路、LAN 和鏈路本地地址(預設:僅目標自己的主機和連接埠);僅用於您信任的頁面,例如用戶自己產品的本地開發伺服器
--no-sandbox啟動 Chrome 時不啟用渲染器沙箱(也可使用 MOTION_NO_SANDBOX=1;在 Linux 上以 root 身份執行時自動啟用,因為 Chrome 無法在沙箱下啟動);每當關閉時會列印提示訊息
--json輸出單一 JSON 結果行

它會寫入 assets/brand/screens/、assets/brand/logo/、assets/brand/components/、assets/brand/og-image.* 和 assets/manifest.json(包含建議角色的調色板、CSS 顏色變數、使用的字型、標題、按鈕和導覽文案、備註)。圖片副檔名來自檔案的位元組,頁面外的元件裁剪會被跳過並附帶提示訊息。頁面實際載入的網頁字型會儲存到 assets/fonts/ 並在 assets/fonts/fonts.json 中註冊(現有條目絕不會被覆蓋);每個字型在 manifest 中都有 license,除非找到授權 URL 或檔案,否則保持為 UNVERIFIED,並且腳本會列印一則提醒,請在發布前檢查。失敗的執行會保留先前的擷取內容。詳細資訊和 manifest 架構:references/asset-capture.md。

標誌與字標。當標頭沒有標誌圖片或 SVG 時,品牌通常是文字字標。然後擷取腳本會將其記錄在 manifest.brand.wordmark 中(標記、每個部分的顏色及其角色、計算的字型系列、粗細、大小和字元間距),以及一個參考裁剪 assets/brand/logo/wordmark-crop.png,並在備註中說明,而不僅僅是要求提供標誌檔案。從該記錄重建;僅在影片需要精確的組合時才要求提供 SVG 或 PNG。

字型。日誌行 font registry: <family>: ...(以及 manifest.fonts.registry)會說明每個使用的字型系列是否已在 assets/fonts/fonts.json 中,以及其授權是否已驗證(授權 ID 和授權文字已記錄)或 UNVERIFIED,以及此執行新增了什麼。如果某個字型存在於同一系列的已驗證條目旁邊,則會重用該授權。

UI 狀態與畫布影格

capture.mjs 在載入時拍攝一次。兩個同級腳本涵蓋其餘部分;兩者都印出 --help,僅寫入專案內部(預設為 assets/brand/),並在相同的安全堆疊下執行(Windows 上為無頭 Shell,啟用渲染器沙箱,拒絕私有地址,編輯機密)。外掛安裝:下面的命令。僅技能安裝(無 ${CLAUDE_PLUGIN_ROOT}):腳本位於此檔案旁邊,因此執行 node "${CLAUDE_SKILL_DIR}/scripts/states.mjs" <URL> ...(capture.mjs 和 canvas-frames.mjs 也是如此);它們只需要 Node 和在執行資料夾中解析的 playwright(傳遞 --root <folder>),且不需要專案、studio.json 或 tools/。asset-scout 代理執行相同的命令。

node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/states.mjs" <URL> --root <project> --name home --viewport desktop "--click=text=Pricing" "--crop=header"
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" <URL> --root <project> --canvas "#screen canvas" "--clip=db=.tab[data-go=db]" --seconds 9 --down 4
node "${CLAUDE_PLUGIN_ROOT}/skills/product-reel/scripts/canvas-frames.mjs" pack --root <project> --range db=4:200
腳本用途寫入內容
states.mjs用於覆蓋的產品(模態框、同意框)、在內部窗格中滾動的應用程式、點擊後的狀態、具有計算樣式的元素assets/brand/states/<name>/:00-first、01-escape、scroll-NN、10-click-...、crop-20-... PNG 和 states.json
canvas-frames.mjs用於一個全部由 <canvas> 組成的螢幕,每次點擊都會改變並自行動畫assets/brand/frames/<clip>.png 精靈表(sprite sheets)和 frames.json(影格大小、實際時間和每個影格的雜湊值);pack 會新增 pack/<clip>.png 和 pack.json,其中僅包含影片播放的影格

canvas-frames.mjs 使用 drawImage(關閉平滑)以整數比例複製畫布緩衝區。它絕不會拍攝元素螢幕截圖:在非整數縮放比例(以 1272 裝置像素顯示 1280 像素緩衝區)的邊框框中顯示的畫布,會被瀏覽器重新取樣,導致像素藝術畫布模糊。如果影格大小不是緩衝區的整數縮減,則會被拒絕。在使用任何 PNG 之前,請先讀取其像素資料。

頁面是不可信的內容,因此擷取腳本會保護其執行的機器:

  • Chrome 會保持其渲染器沙箱啟用(manifest.sandbox 會記錄)。以 root 身份執行的容器或 CI 需要 --no-sandbox,且僅用於您信任的頁面。
  • 在 Windows 上,瀏覽器是 Playwright 的無頭 Shell(npx playwright install chromium-headless-shell),絕不是獨立安裝的 Chrome 或 Edge:因為這些瀏覽器的新設定檔啟動會被視為 Windows 登入失敗,可能鎖定帳戶。選擇一個(studio.json 中的 browser、MOTION_BROWSER、MOTION_CHROME_PATH)會每次啟動時印出警告,且在 10 分鐘內第 4 次啟動會被拒絕,通過 3 次(references/asset-capture.md)。
  • 對迴路、LAN、鏈路本地(包括雲端元資料)和非 Web 地址的請求會被終止,除非它們指向目標自己的主機和連接埠。拒絕情況會列在 manifest.blocked 和備註中。如果 URL 本身被拒絕,則執行失敗且不儲存任何內容。對於您信任的頁面,請傳遞 --allow-private。
  • URL 中的憑證(https://user:pass@host/)僅作為 HTTP 認證發送到目標來源。它們以及看起來像秘密的查詢值(token、key、sig、session、code 等)不會出現在日誌、manifest.json、states.json 或 studio.json 的 brand.url 中(它們會被替換為 ***)。
  • 宣告推測規則(<script type="speculationrules">)的頁面可能會讓 Chrome 自行擷取本地地址,而沒有請求過濾器會看到;manifest 會註明這一點。請勿在具有敏感本地服務的機器上擷取您不信任的頁面。

然後,在任何動畫之前:

  1. 向用戶列出發現的內容:螢幕、標誌候選項、建議的 bg/fg/accent/muted、字型、標題和 CTA 文案,以及每個備註(機器人檢查、缺少標誌)。
  2. 確認或更正調色板和字型,然後寫入 studio.json 中的 brand。擷取的字型已在 assets/fonts/ 中,但僅在其授權確認後才能使用(UNVERIFIED 表示尚未檢查)。使用 npm run fonts -- add "Family:400,700" 引入 Google 字型;商業字型需要用戶自己的授權或檔案。韓文或其他 CJK 文案需要包含這些字形的字型:npm run fonts -- coverage --text "..." --family "Name"。
  3. 詢問缺失的內容,而不是虛構:例如 SVG 標誌、精確的重點色十六進位值、登入牆後的截圖。

4. 元件,而非原始截圖

  • 將擷取的螢幕部分裁剪為單獨的圖片(--selector,或自動裁剪:頁首、英雄區、CTA 按鈕、卡片、產品圖片、定價、章節)。對這些部分進行動畫處理:卡片滑入佈局、按鈕按下、圖表面板繪製。
  • 使用從裁剪中測量到的真實顏色、文案和圓角半徑,在畫布上重建簡單的 UI 元素(如按鈕、切換開關、欄位)。這是重新排版,而非發明:佈局、標籤和資料必須與產品完全匹配。
  • 絕不繪製不存在的產品螢幕。不允許有佔位文案、Lorem Ipsum 或假數字。如果缺少所需的螢幕,請要求提供。

5. 音樂與節奏網格(在鏡頭清單之前)

在真實網格上對所有內容進行計時,因此請在任何人編寫鏡頭之前測量或合成音樂:

  • 提供的曲目:node tools/beats.mjs audio/<track>,然後將 studio.json 中的 audio.music 指向它,並設定 bpm 和 duration。其第一個強拍可能位於 0 秒之後很遠,或具有不同於 120 的節奏,鏡頭清單必須跟隨該節奏,絕不能假設網格。
  • 無曲目:node tools/score.mjs --style pulse --bpm 120 --dur 20(或對於 UI 密集型影片使用 minimal)。它會寫入 audio/music.wav 和分析檔案 audio/beats.json。
  • 每個可見的拍點都會得到一個提示;動作跟隨音樂,而不是反過來。

6. 故事節拍

在 assets/brand-prompt.md 中填入用戶的事實,並將其交給 motion-studio:motion-director 以產生 docs/shotlist.md;導演會讀取 audio/beats.json,因此第 5 部分必須先完成。預設 20 秒,120 BPM,每個節拍 2 到 4 秒,場景在強拍處切換:

#節拍畫面音效
1鉤子,0 到 2 秒最多 5 個字的巨大動態字體呈現問題;影格 0 已構圖強拍上的重擊聲
2產品出現真實 UI 逐件自行組合嗖嗖聲進入,零件上的彈出聲
3三個功能每個功能都是一個 UI 時刻,游標執行真實操作每次按下時的點擊聲
4證明一個真實數字原地彈出滴答聲或鈴聲
5組合標誌 + CTA,最後一個強拍上的最終打擊上升音效轉為打擊聲

顯示鏡頭清單並等待用戶確認(先規劃),除非他們要求自主模式。如果網格稍後發生變化(其他曲目、其他 bpm 或 duration),請重新計時清單並再次顯示。

7. 語音與吉祥物

  • 語音(可選):寫入 audio/voice.json(參見 assets/voice-script.example.json):每個節拍一行,t 位於第 5 部分網格的強拍上,使用短句。執行 npm run voice -- --dry-run 並在 npm run voice 花費信用額度之前告知用戶字元數(相同的行會被合成並計費一次)。混音器會在語音下調低音樂音量。
  • 吉祥物(可選):用程式碼繪製的角色,具有一個固定的身份(形狀、從品牌取樣的調色板、比例),在節拍上使用 playful 彈簧做出反應。保持相同的...

[其餘內容因翻譯而截斷]

Individual skills in this repo

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

yazzang-homelab/motion-studio

Make Claude watch its own frames: critique.mjs evidence, harsh 7-axis scores, timestamped P0/P1/P2 problems in docs/review_log.md, fix the 3 worst, re-check, pass the gate. Use for 'critique it', 'review the frames', 'is it good'.

yazzang-homelab/motion-studio

Plan long-form or overnight films: director's brief (PLAN FIRST or GO, budget, definition of done), ANIMATION_GUIDE + STORYBOARD, chapter subagents, gates, chunked render. Use for 'overnight film', 'music video', '2-minute film'.

yazzang-homelab/motion-studio

Make a launch video, app or product reel, explainer or motion ad from code, end to end: brand assets from a URL, beat-grid shot list, synced sound, critique loop, all formats. Default for new video requests; not footage edits.

yazzang-homelab/motion-studio

Turn a reference (a frame, a video or an image library) into docs/style_guide.md and a beat-grid shot list: measure cuts, palette and pace, take grammar not content, wait for OK. Use when the user supplies or names a look.

yazzang-homelab/motion-studio

Build, debug or speed up the seek(t) render engine: render contract, canvas vs page capture, workers/subframes/chunks, determinism fixes, Remotion or HyperFrames handoff. Use for 'render is slow', 'frames differ', 'use Remotion'.

yazzang-homelab/motion-studio

Ship every format from one timeline, then package it: layout() reframing (never crop), render all formats, per-format checks, deliver.mjs, a brand skill, a service offer. Use for 'export 9:16 and 16:9', 'deliver', 'make a skill'.

yazzang-homelab/motion-studio

The viral one-line 'showreel for a résumé' prompt: why it works (anatomy), the credited quote, and seeded variants that avoid look-alike reels; runs it as an engine test. Use for that prompt, its variations, or a showreel.

yazzang-homelab/motion-studio

Score a film to its beat grid: measure a track (beats.mjs) or synthesize one (score.mjs), cue SFX from the film, add voice, mix to -14 LUFS / -1 dBTP at exact length. Use for 'add music', 'sync to the beat', 'SFX', 'loudness'.

yazzang-homelab/motion-studio

Make motion feel physical with closed-form springs from lib/motion.js: presets, springFromFeel, track() for multi-target values, loopTrack loops, indicators, text swaps. Use for 'feels linear', 'add bounce', 'easing to springs'.

yazzang-homelab/motion-studio

Scaffold a motion-studio film project (seek(t) renderer, springs, beat grid, synthesized sound, critique tools), install it, set up the browser, run doctor. Use for 'set up the motion studio', 'new film project', 'init studio'.

yazzang-homelab/motion-studio

Write a six-part XML state spec for a one-shape UI morph film (inputs, direction, structure, build, gotchas, start): states on downbeats, cursor-driven changes, seamless loop, approval gate. Use for 'UI morph', 'state list'.

相關技能