Communitygithub.com

/cartoon

將故事轉為完整的程式碼動畫電影 (MP4),附帶音效與可選旁白,並提供故事點子、ElevenLabs 旁白稿、YouTube 標題與縮圖建議。用於 /cartoon 或任何要求將故事製作成動畫的請求。

cartoon 是什麼?

這是一個專門用於生成程式碼動畫電影的 AI 技能。使用者只需提供一個故事或故事點子的請求,此技能就能產出一部完整的 MP4 動畫短片,完全由 Python 程式碼繪製每一幀,不使用任何 AI 影像或影片生成器。它採用一致的視覺風格(如描邊角色、深藍夜色調與暖色窗光),並透過 Script 控制鏡頭運動與音效。技能支援多個執行階段:從詢問需求、設定環境、撰寫分鏡、產生影格、混合音軌到最終審核與輸出。此外,它還能獨立產出故事點子、ElevenLabs 旁白稿以及 YouTube 標題與縮圖提示。此技能設計給具備程式碼執行能力的 Claude 使用(如 Claude Code 或 Claude.ai 付費方案),並依賴本地瀏覽器(Chromium)進行渲染。如果執行環境不支援程式碼或瀏覽器,則提供備案方式(生成獨立 HTML 播放器等)。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/eaca89/claude-cartoon-skill/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

cartoon 是做什麼的?

給它一個故事,它就會從程式碼製作出一個短篇動畫電影:簡單的描邊角色、深藍夜色調與溫暖的燈光窗戶、真實的鏡頭運動與音效。完全不使用 AI 影像或影片生成器。Claude 負責編寫電影,而此資料夾中的引擎則繪製每個影格。

它也能提供故事點子、為 ElevenLabs 撰寫旁白稿,以及建議 YouTube 標題與縮圖提示。

所需條件: Claude 需開啟程式碼執行功能。一部完整的電影代表大量的程式碼與長時間的渲染,因此在 Claude 的免費方案中,使用限制通常會在電影完成前耗盡;付費方案才是實際可行的使用方式。僅在需要旁白時才需要 ElevenLabs(或您自己錄製的聲音)。

以下所有內容皆相對於此技能所在的資料夾(存放此檔案的資料夾)。請找到其絕對路徑,並在每個腳本中使用。在 Claude Code 中,此路徑為 ${CLAUDE_SKILL_DIR}。在以下命令中將其稱為 SKILL。請使用 python3,在 Windows 上則使用 python。

步驟 1:確認使用者需求

使用者可能想要完整的套件或只想要其中一部分。只執行被要求的項目:

請求執行內容
故事點子執行下方的「故事點子」,然後停止
製作影片步驟 2-6
撰寫旁白稿閱讀 references/script-playbook.md,交付腳本,停止
標題或縮圖閱讀 references/packaging-playbook.md,交付建議組合,停止
完整套件腳本,接著影片,接著標題與縮圖提示

故事點子

如果未指定長度,請先詢問影片應多長。然後提供 5 個點子,編號列示,讓使用者可以透過編號選擇。每個點子需包含一個簡短名稱、一句話描述發生的事,以及結局。每個點子需符合該長度:少於 20 秒代表一個角色與一個簡單轉折。點子必須容易以 references/engine.md 中的內容進行動畫化,且每個點子須為原創。後續的「製作點子 3」即代表該點子。

步驟 2:建構前先詢問

除非請求已說明清楚,否則請在同一則訊息中一次詢問下列問題,並使用問題工具(若有的話)。跳過任何已回答的問題。若無人可回答,則使用預設值並告知。

  1. 長度: 多長?預設 30 秒。若有 MP3,則以旁白長度為主。
  2. 旁白: 是或否?若已附加 MP3 則跳過此問題。若為是,使用者需提供 MP3 及其腳本文字,或要求您為 ElevenLabs 撰寫腳本並稍後帶回 MP3。不需要 SRT。
  3. 音效: 是或否?預設為是。
  4. 背景音樂: 是或否?預設為否。若為是,若使用者有上傳音軌則使用該音軌,否則使用程式碼產生的音樂背景。
  5. 分鏡圖: 您是否想先看分鏡圖?除非請求已說明,否則一律詢問此問題。若無人可回答,則跳過。

不要預設音樂、音效或旁白。安靜的房間環境音不是音樂。

步驟 3:設定

python3 SKILL/scripts/doctor.py
python3 SKILL/scripts/new_film.py film

doctor.py 會安裝任何缺少的套件。若 Chromium 完全無法執行,請前往「若無法進行渲染」。

接著,依序閱讀:

  1. references/style-bible.md:視覺風格與永不妥協的規則。
  2. references/production.md:快速路徑與已知陷阱。
  3. references/engine.md:工具組,以便重複使用而非重新繪製。
  4. references/film-craft.md:無對白或短片的敘事與鏡頭技巧。

另在相關時閱讀:references/script-playbook.md 用於撰寫腳本,references/voiceover.md 用於 MP3,references/sound.md 用於混音,references/symbolic-beats.md 用於約一分鐘或更長的影片。

步驟 4:規劃影片

在編寫任何繪圖程式碼之前,先撰寫以下內容,因為在程式碼內規劃會產出幻燈片而非影片:

  1. 一句話概括,讓分心的觀眾也能理解。
  2. 一個節奏表,每個節拍包含動作、感受、鏡頭與音效。
  3. 一個世界: 所有角色與道具的固定位置清單。每個鏡頭僅是該世界上的攝影機。
  4. 一個鏡頭清單,使用影格數而非秒數。目標為每 30 秒 8-11 個鏡頭,並包含一個顯示地理環境的遠景。
  5. 若要求的是套件,則包含縮圖時刻,使其作為真實場景存在。

若要求分鏡圖,請在渲染前遵循步驟 5 中的「分鏡圖」。

步驟 5:建構

  1. 取代 film/film.js,保留引擎檔案。從入門影片中的模式開始。
  2. 在最忙碌的時刻檢查靜態畫面,並檢視圖片:python3 SKILL/scripts/stills.py film sheet.jpg 1 4.5 9 ...。正常需要兩輪。
  3. 分鏡圖(若要求)。 執行 python3 SKILL/scripts/storyboard.py film。它會寫出 film/storyboard.jpg,每個鏡頭一個編號預覽,使用與最終影片相同的程式碼繪製。向使用者顯示一個表格,每行一個鏡頭(鏡頭、時間、發生什麼、鏡頭、音效),並顯示或傳送圖片。若無法在此處顯示圖片,則傳送檔案,或僅提供表格並告知。然後停止並等待。根據他們的要求修改影片,若修改幅度大則重新執行分鏡圖,並僅在他們核准後才渲染。
  4. 編輯 film/audio_mix.py 中標記的區塊,以符合聲音簡報。
  5. 使用一個命令進行渲染、混音、合併與稽核:
python3 SKILL/scripts/build.py film --out my-film.mp4

若環境限制命令時間,請在背景執行此命令並輪詢。再次執行相同命令會從中斷處繼續,因為每個鏡頭都是獨立的檔案。修正後,使用 --shots 3 7 僅重新渲染那些鏡頭,或使用 --audio-only 重新混音。

步驟 6:檢查,然後交付

build.py 在結束時會進行稽核。修正每個 ISSUE,或說明為何某個標記出的時刻是刻意為之。然後檢視 film/contact_sheet.jpg,此檔案來自編碼後的檔案。因稽核無法檢查,請目視檢查下列項目:

  • 臉部表情符合預期的情緒,且眉毛不應意外地顯現憤怒。
  • 手部觸摸到應握持的物品,且沒有任何物體越過臉部。
  • 每個行走動作中手臂彎曲方向正確。
  • 門先打開,然後角色才走進去。
  • 在不同鏡頭中,角色與物體的距離保持一致。
  • 任何地方都沒有裝飾性的圓圈。

交付 MP4 並附上簡短說明。明確表示您無法聽到混音:您已測量過,因此使用者應自行聆聽。不要聲稱您未執行的檢查。若使用者要求標題與縮圖,請從包裝手冊中加入建議組合。

若無法進行渲染

若無法執行程式碼或沒有瀏覽器可用,請在可行時執行 python3 SKILL/scripts/bundle_player.py film,此命令會寫出一個 HTML 檔案,該檔案可播放影片並即時錄製 WebM。若您完全無法執行任何操作,請說明缺少什麼,並提供腳本、標題與縮圖提示(這些不需要渲染)。切勿將 WebM 重新命名為 MP4。

關於原創性的規則

使用者分享的參考影片、標題、縮圖或逐字稿僅供參考通用模式:長度、措辭、結構、節奏。切勿複製或保存任何特定於他人作品的內容,也切勿重複使用任何前提、角色、情節、台詞或外觀。每部影片都擁有自己的故事。

相關技能