Communitygithub.com

VisualxIntelligence/motion-tools-and-skills

使用程式碼製作手繪水彩與墨水卡通影片(MP4)——透過 p5.js + p5.brush 在無頭 Chrome 中逐幀渲染,並以 ffmpeg 編碼——主角可以是 Clawd 或任何角色。

motion-tools-and-skills 是什麼?

這項技能提供了一個完整的程式化動畫製作管線,從故事板到最終影片輸出,全在程式碼中完成。它源自於 JohnHeibel 的 PDoomVideo 專案(一首由 Claude Opus 繪製的 156 秒音樂影片)及其通用工具包 ClaudeAnimationBase。核心概念是將每一幀視為時間 `t` 的純函數,使用 `studio.html` 載入 p5.js 和 p5.brush 來繪製 1920×1080 的畫面,然後透過 `render.mjs` 驅動無頭 Chrome 進行並行渲染,最後由 ffmpeg 編碼為 MP4(可選伴音)。此技能支援所有主要平台(Claude Code、Cursor 等),工作流程包括:專案初始化、撰寫故事板、逐鏡頭建置場景、迭代檢視渲染結果(關鍵幀、連續幀、局部特寫)、以及最終影片輸出。它特別強調「手工質感」:只能使用 `paint()` 和 `inkLine()` 模擬水彩與墨水效果,禁止純文字(歌詞影片除外),每個鏡頭必須有明確事件,並確保畫面充滿生命力。此技能也包含了處理音樂同步、歌詞影片、以及將長時間影片分割給子代理的進階功能。

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

在你喜歡的 AI 中提問

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

說明文件

繪畫動畫

一種完全以程式碼製作短篇卡通的技術,源自 JohnHeibel/PDoomVideo(一首由 Claude Opus 繪製的 156 秒音樂影片)及其通用工具包 ClaudeAnimationBase(MIT 授權),後者已作為 template/ 包含在此套件中。

運作方式: 每一幀都是時間 t 的純函數。studio.html 會載入 p5.js + p5.brush 以及你的場景檔案;每個鏡頭會以水彩填色和沸騰墨水線條繪製整個 1920×1080 的畫面。render.mjs 驅動無頭 Chrome 來渲染聯繫表供檢視,或並行渲染每一幀,最後 ffmpeg 將它們編碼成 MP4(可選擇加入音訊)。

工作流程

0. 初始設定

bash ~/.claude/skills/painted-animation/scripts/new_project.sh <project-dir>        # 加上 --keep-demo 保留範例場景

此命令會複製範本、解開示範場景、執行 npm install,並檢查 node / ffmpeg / Chrome 是否就緒。然後在設計任何內容之前,完整閱讀 <project-dir>/ANIMATION_GUIDE.md:裡面包含了規則、動畫原理以及完整的引擎 / Clawd API。使用「讀取」工具查看 docs/emotions.jpg 和 docs/views.jpg(模型表)。

對於音樂影片或長度超過約 20 秒的影片,也請閱讀 references/music-video.md。對於歌詞影片,請先取得歌曲檔案和 LRC 歌詞檔,並使用 scripts/beat_grid.py 測量節奏:歌詞行通常比你想像中還要快。

1. 先寫故事板,再寫程式

在專案中建立 STORYBOARD.md(格式請參閱指南:一句話梗概、世界與色調弧線、主題、角色情感弧線,然後是每個鏡頭及其 閱讀重點 —— 觀眾必須理解的時間點列表)。實作範例:examples/xiaozhen/(一個 31 秒的歌詞影片:包含故事板和完整的場景程式碼)。

在開始建置前,先向使用者展示故事板並讓他們提供意見,除非使用者說直接進行。

2. 逐鏡頭建置

  • 在 src/config.js 中設定 duration、bpm、offset(以及 audio)。
  • 在 src/scenes/ 中,每個場景/章節建立一個 IIFE 包裹的檔案,結尾使用 shots([[t0, fn], ...]);並將其 <script> 標籤加入 studio.html。
  • 先標記關鍵姿勢,以靜止幀檢查,然後再加入兩者之間的動作。

3. 渲染與檢視 —— 每個鏡頭都要檢查多次

你無法透過閱讀程式碼來看到動作。從專案目錄執行:

node render.mjs --sheet=0.1,0.8,1.6,2.4 --cols=4 --w=480 --out=out/check/a.jpg        # 關鍵幀
node render.mjs --strip=2.1:2.6 --out=out/check/strip.jpg                             # 某個時刻的每一幀
node render.mjs --sheet=2.3 --crop=760,420,500,400 --w=500 --out=out/check/face.jpg   # 全解析度細節

用「讀取」工具打開每張圖片,並根據指南的檢視清單實際檢查:事件是否清晰?角色是否夠大?閱讀重點是否安排好,讓初次觀看者能理解?是否有預期動作/跟隨動作?沒有跳幀?腳部和持握的道具有接觸地面/手部?每個接縫處都有轉場?沒有文字、3D、純黑/純白、或模糊的光暈?修正後再次檢查。預算:每個鏡頭至少 1 張聯繫表,每個關鍵動作和轉場至少 1 條連續幀條,每個承載故事的臉部至少 1 個局部裁切。

4. 渲染影片

node render.mjs --clip --out=out/video.mp4                                   # 短片,單一工作執行緒
node render.mjs --frames --workers=4 && node render.mjs --encode --out=out/video.mp4 [--audio=assets/song.mp3]   # 長片,並行 + 可中斷續傳

報告輸出路徑、長度及每幀毫秒數。提供 open out/video.mp4 的建議。

最重要的規則

以下是指南規則的摘要;指南本身是最終權威。

  1. 手工質感。 只能使用 paint() / inkLine()(p5.brush)—— 絕不使用一般的 p5 rect/ellipse/fill。僅限平面 2D:轉向需透過繪製的關鍵視角(turn()、spinView()),絕不使用 3D 投影。透過 glow()(加法混合)來表現光線,因為顏料混合會讓黃色加藍色變成綠色。
  2. 無文字。 沒有字幕、標籤、標誌或對話框;用畫面來表現。反應以繪畫表情符號表示(!、汗水、愛心……)。唯一的例外是歌詞影片中的卡拉 OK 字幕,以及最多幾個大的音效文字。
  3. 每個鏡頭都有事情發生 —— 一個事件、因果關係、鋪陳與收尾。
  4. 為觀眾留時間。 列出每個鏡頭的閱讀重點;一次一個閱讀重點;動作快,意涵停留;引導視線;閱讀重點決定鏡頭長度。這是生成式動畫最容易失敗的地方。
  5. 保持生動。 沒有東西是靜止的(透過 feel() 的閒置動作、飄移的鏡頭、沸騰效果);臉部透過 emotions() 變化,絕不透過交換圖片;角色要夠大(中景 u≈20–28,特寫 40–70);所有東西都要跟隨節奏。
  6. 每個接縫處都要有轉場,並選擇符合故事情境的轉場方式(筆刷擦拭、圓形/異形光圈、甩鏡、匹配剪輯、動作剪輯、鏡頭跟隨)。
  7. 單一作品。 一個世界、一條色彩弧線、一條情感主線、彼此連結的場景、一個與開頭呼應的結尾。

引擎注意事項

  • 時間 t 的純函數。 幀是並行且無序渲染的:不能在幀之間保留狀態、不能使用 Math.random()、不能使用逐幀物理運算。使用 hash(i) 來獲得穩定的亂數,使用 jit() 來實現沸騰效果。
  • 每個獨立的背景元素/道具前都要使用 boilSeed(key),否則一個移動中的物體會導致在其之後繪製的所有東西每一幀都重新沸騰(產生抖動)。
  • 不要使用 p5 已定義的全域名稱。 p5 將 line、OVERLAY、text、color、scale 等定義為全域變數;若頂層宣告 function line() 會失敗,出現 Cannot redefine property,導致頁面永遠無法準備就緒(渲染器會超時)。請將輔助函式保留在場景的 IIFE 內部,或為它們取用不同的名稱。
  • 門口、窗戶和螢幕的分層: 先繪製內部內容,然後將周圍的牆壁/框架重新繪製在上面,如此一來,開口以外的地方就不會顯示更寬的內容(例如火車的 inDoor 加上門框、電視邊框元件)。
  • 點列表中的 NaN 會拋出 Failed to construct 'OffscreenCanvas' 錯誤 —— 請保護好退化的幾何形狀。
  • 在鏡頭縮放 ≳ 2 倍時,巨大的形狀會失去輪廓線;輪廓線的粗細會隨縮放而變化,因此在特寫時需要調低 sw。
  • 成本 = 填色和筆畫的數量。目標是 ≤ 約 1.5–2.5 秒/幀(日誌會輸出每幀毫秒數)。偏好更少、更大的形狀。在沒有真正 GPU 的機器上,水彩填色會很慢——考慮減少 fill 形狀,或者作為最後手段使用 --soft-gl。
  • macOS:渲染器會使用 --use-angle=metal 並自動在 /Applications/Google Chrome.app 尋找 Chrome;否則請傳入 --chrome=<路徑>。

改編指南

  • Clawd 是預設主角,但非必須。新的角色、道具和情緒使用相同的工具(paint、ribbon、through、glow)繪製,並在跨鏡頭時保持角色模型一致;新的情緒請加入 src/clawd.js 的 EMO 物件中。
  • src/karaoke.js(在範本中)透過 core.js 中的 window.overlayHook 鉤子為歌詞影片提供逐字卡拉 OK 功能。
  • LOOPS.name = t => {...}; LOOPS.name.len = 4; + node render.mjs --loop=name --png 可用於製作無縫循環,供 GIF 使用(ffmpeg -i out/loop_name/f%04d.png …)。
  • 使用較高的推理努力程度通常會產生更華麗、細節更豐富的場景。

Individual skills in this repo

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

VisualxIntelligence/motion-tools-and-skills

Make kinetic-typography motion reels (MP4) in code: showreels, portfolio or work reels, product promos, intro films, "motion design"-style videos with bold condensed type, HUD micro-type, black/cream/lime palette, three.js generative layers (particle terrain, liquid marble, chrome knot, particle clouds), shape-continuity transitions and a synthesized, beat-locked score. Canvas 2D + WebGL rendered frame by frame in headless Chrome, encoded with ffmpeg. Use when the user asks for a reel, showreel, motion-graphics / kinetic-type video, a "Work Reel" in this style, or to extend/re-cut the Work Reel ’26.

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.

相關技能