Communitygithub.com

VisualxIntelligence/motion-tools-and-skills

在程式碼中製作動態排版風格(kinetic-typography)的影片(MP4):展示影片、作品集、產品宣傳片、開場影片等,具備粗體壓縮字型、HUD 微字型、黑/奶油/萊姆色調、three.js 生成式圖層、形狀連續性轉場及合成節拍配樂。

motion-tools-and-skills 是什麼?

這個技能讓開發者能完全透過程式碼製作高能量、具編輯風格的動態排版影片。它從一個實際的 84 秒作品集範例「Work Reel ’26」中提煉而成,並提供一個 17 秒的示範範本與完整的工作範例。其核心原理是將每一幀畫面視為時間 `t` 的純函數,透過 `reel/index.html` 載入時間軸(`cues.js`)與渲染引擎(`reel.js`),後者結合了 three.js 的 WebGL 圖層、Canvas 2D 文字繪製與後製特效。最終由 `render.mjs` 驅動無頭 Chrome 瀏覽器逐幀渲染,並透過 ffmpeg 編碼為 MP4 檔案;同時 `music/score.mjs` 可根據相同的時間軸資料在 Node.js 環境中合成節拍鎖定的配樂。 此技能適合在 Claude Code、Cursor 或 Codex 等 AI 代理中使用,當使用者要求製作「作品集影片」、「動態圖像影片」、「動態排版影片」或希望擴充/重新剪輯 Work Reel ’26 風格的影片時可調用。其設計哲學強調文字為主角、每個鏡頭都有明確的視覺機制、節拍鎖定、形狀連續性轉場以及誠實的資料呈現。支援完整的開發工作流程:從腳本構思、分鏡表撰寫、逐幀檢查與除錯、配樂合成、最終渲染,到將成品作為網站開場頁面部署,皆一體化完成。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/VisualxIntelligence/motion-tools-and-skills/tree/HEAD/skills/kinetic-reel

在你喜歡的 AI 中提問

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

說明文件

Kinetic reel

這是一種完全以程式碼製作編輯級、高能量動態作品集影片的方法,源自「Work Reel ’26」(一部 84 秒的作品集影片:Microsoft → UW–Madison Surgery → Enterprise RAG → trace finale)。它包裝為一個可執行的 template/(一個 17 秒的示範,使用了所有技術)和一個完整的工作範例 examples/work-reel-26/(上游僅提供:https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26)。

運作方式。 每一幀畫面都是時間 t 的純函數。reel/index.html 載入 reel/cues.js(時間軸)和 reel/reel.js(一個 ES 模組:three.js 圖層、一個 2D 文字畫布和一個 WebGL 後製通道)。render.mjs 驅動無頭 Chrome 瀏覽器來渲染聯繫表、條狀圖和靜止畫面以供審查,或平行渲染每一幀,然後 ffmpeg 編碼為 MP4。music/score.mjs 在 Node 中根據相同的 cues.js 合成配樂,因此每個重拍都能精準落在其畫面上。

工作流程

0. 建立專案架構

bash ~/.claude/skills/kinetic-reel/scripts/new_project.sh <project-dir>

然後在開始設計之前,完整閱讀 references/style-guide.md(外觀、動態詞彙、轉場目錄、版面規則)和 references/sound.md。大致瀏覽 examples/work-reel-26/reel.js(未複製於此;請參閱 https://github.com/tuzhechen2005/opus-video-skills/tree/main/skills/kinetic-reel/examples/work-reel-26)以了解長篇影片的組織方式。

1. 決定重點,然後製作分鏡表

  • 詢問(或確定)什麼是主軸,以及每個部分分配多少時間。觀眾會注意到比例:Work Reel 的第二版中 Microsoft 佔了大約 60%,因此必須重新平衡。解決方案是為其他章節增加播放時間,而不是刪減人們喜愛的部分。目標是讓主軸佔約 35–40%。
  • 從範本撰寫 STORYBOARD.md:時間預算、事實的來源真相、一個統一的設計手法,以及每個鏡頭一行(標題、視覺機制、轉場進入、聲音)。
  • 事實是神聖的。 只使用提供的來源中的數據,每個數據都要附帶其範圍(「約 180 個自建案例」、「320 個雙語提示」)。任何說明性的內容(工具 ID、文件 ID、範例答案、AST)在 HUD 中都要標示為 SCHEMATIC。切勿繪製你沒有的逐維度數據。視覺化的是流程。醫療/臨床相關工作:不得做出療效聲明,若屬實則應說明「開發中 / 尚未驗證」。

2. 建構

  • reel/cues.js:S(場景開始)、hits(每一個重要的節拍)、CH(章節 → 分段進度條)、dur。120 BPM:切割點落在節拍上,章節變換落在小節上。
  • reel/reel.js:每個鏡頭一個函數,sName(t)。每個函數繪製整個畫面:bg() → 透過 glShot(...) 建立 GL 圖層 → 文字和形狀 → hud(t, {...})。在 SCENES 中註冊鏡頭並附上 key;在 TR 中加入轉場(或省略以在節拍上進行硬切)。
  • 維持 CJK 常數,列出你繪製的每個中文字元(字型會以子集方式載入)。

3. 仔細檢查每個鏡頭,多看幾次

node render.mjs --sheet=1,4,7,10,13,15.5 --cols=3 --w=640 --out=out/check/sheet.jpg   # 關鍵影格
node render.mjs --stills=10.4 --out=out/stills                                          # 全解析度細節
ffmpeg -ss 16.0 -t .6 -i out/reel.mp4 -vf "fps=10,scale=320:-1,tile=6x1" out/check/tr.jpg   # 一個轉場,來自編碼後的影片

用 Read 開啟每張圖片。檢查是否有碰撞(標籤壓到線條、統計數字疊到統計數字、文字進入 HUD 區域)、在剪接點出現空白影格、寬度 1600 px 時的可讀性,以及每個轉場必須從某個東西開始並乾淨地結束。預算:每個章節一張聯繫表、每個密集鏡頭一張全解析度靜止畫面、每種轉場類型一條條狀圖。

4. 配樂、渲染、編碼

node music/score.mjs && ffmpeg -y -i music/score.wav -af "highpass=f=30,equalizer=f=250:t=q:w=1:g=-2,loudnorm=I=-14:TP=-1.2:LRA=8" -c:a aac -b:a 192k assets/score.m4a
node render.mjs --frames --workers=4                                    # Mac GPU 上約 8–40 毫秒/幀:只需數秒,而非數分鐘
node render.mjs --encode --audio=assets/score.m4a --out=out/reel.mp4 --fps=30
# 網路用副本:ffmpeg -i out/reel.mp4 -vf scale=1600:900:flags=lanczos -c:v libx264 -preset slow -crf 23 -c:a aac -b:a 128k -movflags +faststart out/reel-web.mp4

你無法聽到配樂:使用 showspectrumpic 和每個區段的 RMS 來檢查,並在報告時說明。僅修改音訊時無需重新渲染:重新封裝即可(-map 0:v -map 1:a -c:v copy)。

最重要的規則

  1. 文字是主角。 壓縮顯示字型(Anton)用於標題、寬體怪诞字型(Archivo Black)用於衝擊性語句、斜體襯線字型(Instrument Serif)用於唯一的「聲音」台詞、等寬字型(JetBrains Mono)用於所有標籤。大的英文標題,小的中文註解(當觀眾為雙語時)。
  2. 每個鏡頭都有一個視覺機制,而不只是文字:網格路由、矩陣掃描、token 在狀態機間跳躍、列表融合、封包通過閘門。標題命名機制;機制證明標題。
  3. 節拍鎖定。 字母、晶片、計數器和剪輯點都落在 hits 上。快速進入(expo-out)、停頓、然後下一拍。
  4. 連續性。 在一個章節內部,優先使用形狀連續性轉場(透過眼睛注視的元素放大、從剛剛亮起的東西進行虹膜轉場),而非硬切。硬切加上衝擊效果則用於章節轉換。
  5. 不要使用雜訊嘶嘶聲。 在章節開始時使用調性內的漸強音,章節內部使用安靜的音調提示,約一半的剪輯點使用靜音。
  6. 誠實的數據(參見步驟 1),任何說明性的內容都要標上 SCHEMATIC 標籤。
  7. 保護數學運算。 從 backOut() 計算出的半徑可能低於 0(Canvas 拋出錯誤):circle/starburst/jelly 已內建保護。在合成器中,在呼叫 pow() 之前將局部時間限制為 ≥ 0,並限制 SVF 的 f/q 值(範本中均已內建)。

將影片作為網站開場頁面部署

Work Reel 以網站進入頁面的形式部署:index.html 全螢幕播放影片,然後轉交控制權給作品集。此模式已包裝在 examples/site-intro/ 中(index.html、css/intro-reel.css、js/intro-reel.js,以及一個支援 HTTP Range 的 Cloudflare Worker):

  • 嘗試自動播放並開啟聲音。如果被拒絕,則靜音播放並顯示脈動的「點擊開啟聲音」。如果也被拒絕,或使用者設定 prefers-reduced-motion,則顯示「開始」模式的結束畫面(播放是主要按鈕)。
  • 播放期間:頂部中央顯示小型玻璃藥丸狀提示,因為影片的 HUD 佔據了角落。「跳過開場」帶有一個隨著影片進度填充的圓環。聲音切換鈕的等化器條會以影片的 BPM 脈動。Esc 跳過,M 靜音。
  • 結束畫面:使用 HTML 重現影片的語法。角落括號、以 drop-in 字母(Anton)顯示的名字、等寬微字型、分段軌跡條、一個粒子地形的 2D 點陣版本、一個萊姆色主要 CTA(懸停時文字滾動、光澤、磁性、每個小節脈動一次),以及一個幽靈般的「再看一次」。
  • 透過從按下的控制項進行萊姆色虹膜轉場,降低音訊,然後導航。
  • 兩個編碼版本(1600×900 約 1.3 Mbps,960×540 約 0.6 Mbps 用於手機 / 省流量模式),preload="auto",一張海報圖片。請使用 HTTP Range(206)提供服務,否則 Safari 的搜尋功能會出問題。

Individual skills in this repo

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

VisualxIntelligence/motion-tools-and-skills

Direct and produce a short film made entirely in code, in one of the styles of the Lemo-Opuscar library (e.g. Impasto Oil Painting 油画厚涂, Watercolor Brush 水彩笔刷, Chinese Ink Wash 中国水墨, Ukiyo-e 浮世绘, Whiteboard Explainer 白板讲解). Use when the user asks for a video, film, short, promo, explainer or animation (视频、短片、动画、宣传片) in a named style; when they want a film made about their own topic and haven't chosen a style (help them choose); or when they ask which film styles there are. Not for editing or converting existing video files.

VisualxIntelligence/motion-tools-and-skills

Create and revise animated character music videos from a supplied song and creative prompt, with researched storyboards, Fal character and video generation, p5 motion graphics, audio editing, and Swift VFX. Use for full music videos or revisions to their characters, scenes, animation, sound, and effects.

VisualxIntelligence/motion-tools-and-skills

Make hand-painted watercolour-and-ink cartoon videos (MP4) with code — p5.js + p5.brush rendered frame by frame in headless Chrome, encoded with ffmpeg — starring Clawd or any character. Use when the user asks to make an animation, animated short, cartoon, music video, lyric video, animated GIF/loop or "a video of Clawd…", or mentions the PDoomVideo / ClaudeAnimationBase approach. Covers storyboarding, the engine API, the render-and-look review loop, music/lyric sync and splitting long videos across subagents.

相關技能