Communitygithub.com

UgurKeskekci/claude-video-kit

生成叙事性动态图形视频(Remotion),用数字和文字讲述故事——适用于 X/Twitter 帖子、Reels/Shorts、YouTube 视频插页。故事以 JSON 场景列表编写,支持 16:9 和 9:16 渲染,并合成柔和的 whoosh、键盘声和宁静的背景音乐。

claude-video-kit 是什么?

该技能基于 Remotion 框架,将实验、测试或想法的故事转化为 15-30 秒的动态图形视频,重点突出数字和文本。视频风格固定且精致:优雅的衬线标题 + 斜体强调词(天蓝色)、小间距大写等宽标签、紧凑粗体无衬线数字;持续显示细边框(左上角品牌名、右上角“01 — 章节”、底部带分段的进度条和时间),背景是微弱网格、边缘暗角和颗粒纹理。故事以 JSON 场景列表形式编写,支持标题、文本逐字输入(带键盘音效)、计数器(带数字滚动)、水平仪、柱状图、比较、列表和问题等场景类型。可同时渲染 16:9 和 9:16 比例,并自动合成音频(包括 whoosh 转场音、键盘敲击声和合成背景音乐)。输出视频会进行严格的自动检查:帧数、时长、音画同步、LUFS 响度和峰值。该技能设计用于场景如“为 X 制作动画/视频”、“动态图形”、“用数字讲述”、“可视化结果”、“比较视频”、“以动画形式呈现测试结果”、“Reels 图形”、“视频插页图形”等。它支持 X/Twitter、Instagram Reels/Shorts 和 YouTube 平台,并在您需要将数据驱动的叙事转化为专业、精致的短视频时最为有用。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

编辑性动态图形(Remotion)

将实验、测试或想法的故事转化为 15-30 秒、以数字和文字为主的视频。外观固定而精致:优雅的衬线标题 + 斜体强调词(天蓝色)、小间距大写等宽标签、紧凑粗体无衬线数字;持续显示细边框(左上角品牌名、右上角“01 — 章节”,底部带分段的进度条 + 时间),背景是微弱网格、边缘暗角和细腻颗粒纹理。故事用 JSON 编写,视觉由此生成。

如果需要绘图、角色或手绘场景,这不是本技能而是 animasyon 技能(PIL 墨水)。

示例:ornekler/x-animasyon/ornek.json(“用三种不同设置运行同一任务”;数字为 捏造的演示数据,屏幕上显示“示例数据”)。

安装(一次性)

cd remotion && npm install      # Node 18+;字体文件夹自动复制到 public/fonts

首次渲染会下载 Chrome Headless Shell(约 100 MB)。Python 部分需要:numpy、Pillow、ffmpeg。 命令中 Python 使用 .venv/bin/python(Windows 使用 .venv\Scripts\python)。

工作流程

1. 理解故事

核心论点是什么?有哪些数字,来自何处?平台和比例(X:16:9,Reels/Shorts:9:16,或两者皆可),时长(X 15-30 秒)。如果没有数字,则捏造数字:要么向用户请求实测数字,要么使用无数字的场景(标题、列表、问题)。

2. 编写场景列表:calisma/x-animasyon/<ad>.json

从示例中复制。规则:

  • 每个场景 一个想法,每行 3-7 个单词,自然简洁的中文。用两行代替长句。
  • *单词* = 强调(衬体中斜体 + 蓝色)。每个场景最多一个强调。
  • 数字只能是实测的。 如果使用未测量/示例数字,请在顶层保留 "etiket": "örnek veri" 并告知用户。
  • 中文中百分号在数字后:"onek": "%" → 80%。货币和时间比较请使用现成文本:"$0,61"、"5 分 12 秒"。
  • bolum 开启新章节(右上角标签 + 进度条的一部分);3-5 个章节足够。
  • 使用“待处理”、“即将推出”等状态徽章和给自己写的备注;屏幕上的每个文字都是面向观众的。
tur字段用途建议时长
baslikust?, satirlar钩子:前 2-3 秒2.4-3
yazisatirlar?, ust?, metin (≤160)逐字输入提示/命令,带键盘音效0.55 + 字符数 × 0.09 + 0.9
sayacust?, deger, baslangic?, ondalik?, onek?, sonek?, alt?单个大数字滚动出现3
olcersatirlar, seviyeler[2-6] (ad, etiket?)概念级别:从低到高依次填充3-4
sutunlarsatirlar, ogeler[2-6] (ad, deger, etiket?), onek/sonek/ondalik?, not?实测结果,自动排序标签4-4.5
karsilastirmasatirlar (单行), a, b (ad, ust?, deger, altEtiket?, alt?), fark? (deger, etiket?, alt?)A vs B:成本、时间4-5
listesatirlar, ogeler[2-5]推理、规则、步骤1.6 + 0.5 × 项目数
sorusatirlar, alt?结尾问题/行动号召3

每个场景必须指定 sure(秒),bolum 可选。顶层字段:marka(左上角名称)、etiket?、tema?、sahneler。架构:remotion/src/x/sema.ts。

3. 草稿(快速预览)

.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<ad>.json --oran ikisi --taslak

半尺寸、静音渲染 + 联系页(<ad>-<oran>-taslak-sessiz-sayfa.jpg)。打开页面并检查:溢出的行、重叠的元素、不可读的标签、空白的大面积区域。修正后重新生成草稿。如需实时编辑:cd remotion && npx remotion studio。

4. 渲染 + 音频

.venv/bin/python .claude/skills/x-animasyon/araclar/uret.py calisma/x-animasyon/<ad>.json --oran ikisi

输出到 calisma/x-animasyon/:<ad>-16x9.mp4(1920×1080,60 fps)和 <ad>-9x16.mp4(1080×1920,30 fps),带音频。音频电平默认 -26 LUFS:明显低于语音(-14..-16),如果叠加配音或说话人头也不会淹没。如果单独发送请使用 --lufs -18;如需无音乐请使用 --muziksiz。

逐步执行(相同过程):

cd remotion && npx remotion render XAnimasyon16x9 ../calisma/x-animasyon/<ad>-16x9-sessiz.mp4 \
    --props=../calisma/x-animasyon/<ad>.json --muted && cd ..
.venv/bin/python .claude/skills/x-animasyon/araclar/ses.py calisma/x-animasyon/<ad>.json \
    --video calisma/x-animasyon/<ad>-16x9-sessiz.mp4 --cikti calisma/x-animasyon/<ad>-16x9.mp4

5. 测量——不能只看、不能只听

uret.py 末尾会运行 olc.py(手动:olc.py <mp4> --json <json>):

  • 帧数和时长是否与 JSON 预期一致,音频和视频长度是否相同;
  • 联系页:每个场景两帧(中间和退出前)——务必打开查看;
  • 集成 LUFS 和真实峰值;每个切点处 whoosh 比背景高多少 dB(低于 2 dB 发出警告)。文本场景后的切点差异较小:前一窗口有按键音,属于正常。 无法测量的项目(音乐是否好听、节奏是否正确)明确留给用户判断。

6. 交付

文件路径、时长、渲染时间和测量摘要。如果使用了示例数据,请再次说明。

调整外观

  • 颜色: JSON 中的 "tema": {"vurgu": "#38bdf8", "zemin": "#111113", "yazi": "#ece7df", "soluk": "#8b8883", "seri": [...]}。保持单个强调色;seri 是量表/柱状图的颜色。默认值在 remotion/src/x/parcalar.tsx。
  • 品牌: "marka" 是左上角名称(频道或系列名称)。
  • 字体: 仅限可自由分发的字体(如 OFL)。将 TTF 和许可证文本放入 fontlar/,添加到 remotion/scripts/fontlari-kopyala.mjs 列表和 remotion/src/x/fontlar.ts 中的 YUZLER 中,然后执行 npm run fontlar。操作系统自带字体(macOS/Windows 系统字体)不得加入仓库,不得分发。
  • 布局: 两个方向在 useDuzen() 中处理(parcalar.tsx)。竖屏时内容位于 y 300-1320 之间:Reels/Shorts 界面顶部约 190 px,底部约 520 px,并会遮挡右下角。
  • 新场景类型:向 sema.ts 添加架构,向 sahneler.tsx 添加组件,向 SahneCiz 添加分支,并向 uret.py 的 TURLER 添加名称。如果场景内需要音效(如键盘声),请使用 zaman.ts 在 araclar/ortak.py 中以相同的公式计算时间。

陷阱(已测量)

  • 唯一时间源: remotion/src/x/zaman.ts 和 araclar/ortak.py 执行相同的计算(帧舍入、输入节奏)。修改其一却忘记另一个,会导致 whoosh 从切点偏移,按键音从字符偏移。
  • 合成 ID 中不能有下划线;--props 传入的是 文件路径,而非内嵌 JSON。
  • 字体通过 FontFace API 加载;不等待 document.fonts.ready(在长时间渲染中,曾观察到某个选项卡从未解析)。如果字体加载失败,渲染会报错并停止,不会静默使用后备字体。
  • 颗粒纹理不是在每帧通过 SVG feTurbulence 计算(会阻塞渲染):而是使用一次生成的噪声图块并移动。
  • 土耳其语大写通过 CSS 处理(lang="tr" + text-transform):İ/ı 输出正确。不要使用 JS 的 toUpperCase()。
  • 不要给文字添加缩放(zoom/pop)动画:会抖动。入场 = 从蒙版升起 + 透明度变化。
  • 如果长时间 60 fps 渲染卡住,可以分成 --frames=0-899 等片段,然后用 ffmpeg concat 合并。
  • 测量的渲染时长(M1 Pro,16 GB,默认并发):27.4 秒的示例,16:9@60 约 67 秒,9:16@30 约 40 秒;草稿(半尺寸)33 / 18 秒。

许可说明:Remotion

Remotion 不是 MIT 许可的。对个人和小型企业免费;超过一定规模的企业需要购买付费许可。使用前请检查最新条款:https://www.remotion.dev/license —— 本仓库中的代码是 MIT 的,但 Remotion 本身受其自身许可约束。

Individual skills in this repo

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

UgurKeskekci/claude-video-kit

Kodla (görsel üretim modeli OLMADAN) hikâye anlatan kısa mürekkep çizgi animasyonu üretir — X/Twitter gönderisi, Reels/Shorts, YouTube video arası ya da soğuk açılış. Görüntü PIL mürekkep motoruyla, müzik ve efektler numpy sentezi ile aynı zaman programından üretilir, sonuç ölçülerek denetlenir. Şu durumlarda kullan: "animasyon yap", "çizgi animasyon", "halimi anlat", "durumumu göster", "twitter için animasyon", "reels animasyonu", "araya animasyon", "çöp adam animasyonu", "kodla video", "one-shot animasyon".

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

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".

相关技能