Communitygithub.com

UgurKeskekci/claude-video-kit

使用程式碼(不含任何影像生成模型)產製敘事性短片墨水手繪動畫 — 適用於 X/Twitter 貼文、Reels/Shorts、YouTube 過場或開場。影像由 PIL 墨水引擎生成,音樂與音效則透過 numpy 合成,全程同步且可量化校驗。

claude-video-kit 是什麼?

這項技能讓 AI 代理能夠僅透過程式碼生成簡短的墨水風格手繪動畫,完全不需要依賴任何影像生成模型。它非常適合用來製作社群媒體貼文(X/Twitter、Reels/Shorts)、YouTube 過場動畫,或是任何需要快速敘事的情境。技能背後使用 Pillow 繪製逐格圖像(數位墨水),並透過 numpy 即時合成音樂與音效,整個過程在單一合作會話中完成。動畫輸出是確定性的,且可在逐幀基礎上進行微調。如果開發者需要一個無版權爭議、完全由程式碼驅動、且便於反覆修正的敘事動畫方案,這項技能會非常實用。其工作流程包含規劃拍點表、使用特定函式庫(kit/murekkep.py 與 kit/sentez.py)實作視覺與音訊,並在最終渲染前進行預覽與量化校驗。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/UgurKeskekci/claude-video-kit/tree/HEAD/.claude/skills/animasyon

在你喜歡的 AI 中提問

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

說明文件

用程式碼製作墨水動畫

使用者描述一個狀況或故事(例如「在社群媒體上混了一週,我快瘋了」),你將它轉化成一部簡短、單一概念的動畫。沒有任何影像生成模型:每一條線都是程式碼,每一段聲音都是合成。沒有版權問題,結果是確定性的,而且可以逐格修正。

可運行的範例(作為模板參考):ornekler/animasyon-bir-hafta/——7 天的時間跳躍,4:5 比例,17.7 秒,與程式同步的音樂和音效。

先閱讀:references/ilkeler.md(為何有效、平台表格、主題發想、誠實原則)以及 references/tarifler.md(引擎選擇、構圖、角色、聲音、校驗——所有經過測量發現的陷阱)。

指令中請使用 .venv/bin/python(Windows 使用 .venv\Scripts\python)。 相依套件:numpy, Pillow, ffmpeg。

工作流程

1. 簡短討論

如果概念不明確,或使用者表示「先討論一下」:提出 3-4 個概念(每個一句話的梗 + 為何有效),並推薦其中一個。只進行一輪提問:概念、比例(X:4:5 / 16:9,Reels:9:16)、時長。如果使用者說「先討論,不要產出」,則不要寫程式碼。

2. 拍點表(Beat Sheet)——寫程式碼之前

以秒為單位規劃:每個拍點 = 單一視覺概念 + 最多一句簡短台詞。

  • 時長:X 15-30 秒,Reels 20-40 秒,YouTube 過場 3-8 秒。如果使用者要求簡短,則採取下限。
  • 結構:錨點(角落的固定計數器:天/年)+ 重複出現的角色 + 每場景單一物件 + 漸進昇溫 + 呼應開頭的結尾。如果結尾與開頭相連,影片就能循環播放。
  • 聲音的重點時刻(拍點、切換、靜音)必須在規劃時就寫入,不得事後追加。

3. 引擎

  • 繪圖、角色、粒子、堆疊 → 此技能:kit/murekkep.py + kit/sentez.py。
  • 數字、文字、圖表為主的動態圖形(計數器、長條圖、比較圖)→ x-animasyon 技能(Remotion)。
import sys; sys.path.insert(0, ".claude/skills/animasyon/kit")
import murekkep as M, sentez as Z

專案資料夾 calisma/<名稱>/:包含 anim.py(影像 + program())、ses.py(讀取同一個程式)。複製範例後開始;透過常數 KOK 和 CIKTI 修改路徑。

模組元件功能說明
M.Tuval(w, h)紙質紋理背景(繪製兩次,bitir() 縮小:產生柔和邊緣)
M.Kalem(d, kare, s, sc, ox, oy)暈染的墨水線條、圓形、多邊形、文字;場景變換
M.Iskelet、M.yuru、M.poz_karistir關節角色、程序化行走、姿勢混合
M.yaz_mp4(kare_fn, sure, yol, w, h, ses=wav)將幀透過管道傳送給 ffmpeg,並加入音訊
Z.harp/yayli/bas/flut/taiko樂器(音高經過校正)
Z.whoosh/tus/yazma/ding/tik/hisirti/swell音效(whoosh 柔和,鍵盤模仿人類節奏)
Z.yanki、Z.kes、Z.yaz_wav(buf, yol, lufs)迴音、喜劇式斷點、輸出指定 LUFS 的 wav

4. 預覽 → 修正 → 最終渲染

在完整渲染之前,先輸出 4-6 個關鍵幀的 PNG(範例中使用 --kare 2,7.5,15.5)並自行檢查。第一輪總是會發現問題:擁擠的構圖、遮擋文字的物件、重複的文字、不該出現的東西從空隙中露出來。修正後再進行完整渲染。將預覽與完整渲染串聯在同一個指令中:沒看到關鍵幀就不要跑長時間的渲染。

5. 量化校驗——你不能用眼睛看,也不能用耳朵聽

.venv/bin/python .claude/skills/animasyon/kit/denetim.py calisma/<名稱>/<名稱>.mp4

檢查接觸頁面 + LUFS / 真實峰值 + 0.5 秒音訊輪廓 + 視覺過渡。如果合成音符有變更,使用 --perde。檢查規劃的靜音、拍點和斷點是否到位。無法量化的部分(音色好聽嗎?梗好笑嗎?)則明確留給使用者判斷。

6. 交付 + 貼文文案

提供檔案路徑、時長、大小以及校驗摘要。貼文文案 2-3 行:故事的核心句子。 誠實原則:「單一提示 / one-shot」的宣稱僅限於真正一次就生成成功的情況;如果是經過多輪修正才完成,就不要說「一次完成」。正確說明是由哪個模型產出的。

規則

  • 文字不進行暈染或縮放;每場景最多一行。字型中不包含表情符號。
  • 移動物件不得進入標題/計數器橫幅區域(進入前須淡出)。
  • 只使用一種強調色(在墨水作品中為通知紅);其餘保持紙張 + 墨水的顏色。
  • 直向作品中,底部約 520 px 以下以及右側 x > 900 的區域為平台介面:不要在那些位置放置文字。
  • 音訊:單獨影片為 -15 LUFS;下方有語音時,音樂必須明顯低於語音。音樂只能來自合成或用戶自行驗證過授權的來源。
  • 畫面上不得有未經校驗的數字;如果是範例數字,必須明確標示。
  • 如果測量到新的陷阱,請寫入 references/tarifler.md;如果產生了新的可重複使用的元件(過渡效果、角色綁定擴充),請收入 kit/。

Individual skills in this repo

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

UgurKeskekci/claude-video-kit

Konuşan kafa kaydından (kamera, ses içinde; yatay 4K ya da dikey) dikey Instagram Reels / YouTube Shorts / TikTok videosu (1080x1920, 30 fps) üretir, "kart" formatında - üstte söylenen kelimede beliren sade arayüz kartları (sohbet balonu, liste, harf harf yazılan terminal, dosya ağacı, büyük sayı, gerçek ekran görüntüsü), altta yuvarlak köşeli yüz kartı, aralarında kelime kelime altyazı, kart geçişinde yumuşak whoosh, yazarken klavye sesi, sonda "yorumlara yaz" sorusu. Şu durumlarda kullan - "reels yap", "bundan reels çıkar", "shorts yap", "dikey video", "kartlı reels", "bilgi veren reels", "ipucu videosu", "üstte kart altta yüz", "yorumlara yaz diye bitsin", "tips reels".

UgurKeskekci/claude-video-kit

Sayı ve yazıyla hikâye anlatan editoryal hareketli grafik videosu üretir (Remotion) — X/Twitter gönderisi, Reels/Shorts, YouTube video arası. Hikâye JSON sahne listesi olarak yazılır (başlık, yazılan istem, sayaç, ölçer, sütunlar, karşılaştırma, liste, soru), 16:9 ve 9:16 render edilir, yumuşak whoosh + klavye + sakin müzik yatağı numpy ile sentezlenip eklenir, sonuç ölçülerek denetlenir. Şu durumlarda kullan: "X için animasyon/video", "hareketli grafik", "motion graphics", "sayılarla anlat", "sonuçları grafikle göster", "karşılaştırma videosu", "test sonucunu animasyonla anlat", "reels grafiği", "araya grafik", "Remotion".

UgurKeskekci/claude-video-kit

Yatay YouTube konuşma videosunu (kamera kaydı, isteğe bağlı ayrı ekran kaydı) kaba kurgular. Harfiyen döküm çıkarır, duraklamaları ve art arda tekrarları sesten keser; Claude dökümü okuyup gerekçeli bir atma listesi yazar, mp4 üretilir, kesilmiş ses yeniden çözülüp her birleşim denetlenir. Şu durumlarda kullan - "videoyu kurgula", "kaba kurgu", "ham kaydı kes", "beklemeleri/duraklamaları kes", "tekrarları at", "takılmaları temizle", "jump cut", "keseceğim dediğim yerleri at", "kamera ile ekran kaydını senkronla", "ekran kaydının köşesine kamera koy", "sessiz yerleri hızlandır".

相關技能