Communitygithub.com

UgurKeskekci/claude-video-kit

将说话人录制的视频(横屏4K或竖屏)转换为Instagram Reels / YouTube Shorts / TikTok格式(1080x1920, 30fps)的“卡片式”竖屏视频:顶部显示随说话同步出现的简洁UI卡片(聊天气泡、列表、逐字终端、文件树、大数字、真实截图),底部显示圆角面部卡片,中间为逐词字幕,卡片切换带平滑whoosh音效,打字带键盘声,结尾提示“评论区写下你的答案”。适用于“做Reels”、“出Shorts”、“竖屏视频”、“信息类Reels”、“提示视频”等场景。

claude-video-kit 是什么?

这是一个专为AI编码助手(如Claude Code)设计的技能,用于将说话人录制的横屏或竖屏视频自动剪辑成流行的竖屏短视频格式。其核心特色是“卡片式”信息展示:视频顶部区域会动态弹出与语音同步的UI卡片(如列表、代码、截图等),底部显示说话人面部,中间配有逐词字幕和合成音效。 该技能通过一系列自动化脚本(基于Python+ffmpeg)实现:先进行语音转写和剪辑,再根据转写内容生成带有时间锚点的剧本(JSON格式),确定每张卡片出现的具体词汇位置。随后自动添加转场特效、键盘打字声等,最终渲染出符合安全区域要求的成品视频。 它特别适合制作知识科普、产品教程、技巧分享类短视频,让复杂信息以视觉卡片形式清晰呈现。支持Claude Code和Cursor等平台,需要Python环境、ffmpeg及预装依赖。

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

在你喜欢的 AI 中提问

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

文档

Reels(卡片格式)

将说话录制视频转换成竖屏短视频,其中每个要点都以一张卡片形式显示在屏幕上方。 工作流程如下:

  • 工具 负责测量音频并进行剪切(yatay-kurgu 技能的转写/剪辑工具)、绘制卡片和字幕、平衡音频,并对最终结果进行测量。
  • 你(Claude) 阅读转写稿,选择要删除的部分,确定每张卡片在哪个词汇处出现并写入 senaryo.json,然后检查控制图像。

你无需输入秒数:卡片绑定到所说的词汇;即使剪辑发生变化,卡片也会保持原位。

准备工作

  • ffmpeg 在 PATH 中,Python 依赖通过仓库根目录下的 kur.sh 安装。命令中使用 .venv/bin/python 作为 Python 解释器(Windows 使用 .venv\Scripts\python)。不需要支持 libass 的 ffmpeg:字幕使用 Pillow 绘制。
  • 使用同一仓库中其他两个技能的工具,不修改它们:yatay-kurgu(精确的转写 + 音频剪辑)和 x-animasyon(whoosh 和键盘音效合成)。
  • Whisper 模型在首次运行时下载(large-v3 ≈ 3 GB);下载前告知用户。
  • 字体仅使用仓库根目录下的 fontlar/(OFL 协议):Inter、Newsreader、IBM Plex Mono。
  • 每个任务位于自己的文件夹中:calisma/reels/<名称>/。原始录制文件为只读权限。

以下 R = .venv/bin/python .claude/skills/reels/araclar/reels.py,P = calisma/reels/<名称>。

循环

1. 转写。

R dokum P --video kayit.mp4 [--bas 56 --sure 42] [--terimler "视频专属术语"]

如果录制较长而 Reels 只截取其中一部分,使用 --bas/--sure 指定窗口(片段将输出为 P/kaynak.mov,原始文件不变)。目标:35-45 秒的输出。

2. 阅读转写稿,进行剪辑。 从头到尾阅读 P/dokum.md(遵循 yatay-kurgu SKILL.md 中的规则)。停顿和连续重复已自动删除;你需要将以下内容写入 P/atilacak.json,每行附上理由:

  • 重新开始(保留最后一次尝试)、剪辑注释(“我将删除这一段”)、说错并纠正的数字;
  • 听不清的词语:在两个版本中都模糊不清的部分不添加到字幕中,直接删除(使用 .venv/bin/python .claude/skills/yatay-kurgu/araclar/kurgu.py pencere P <秒> 重新解析);
  • 对 Reels 来说多余的离题内容:属于内容决策,询问用户。

根据音频确定剪辑点:按 dokum.md 的行边界写出区间,工具会将该点对齐到 ±0.2 秒内的最静音帧。然后运行:

R kurgu P        # 重新构建剪辑计划
R kelimeler P    # 剪辑中保留的词汇及其输出时间(从此处选择锚点)

3. 剧本:P/senaryo.json。 示例:ornekler/reels/senaryo.ornek.json。字段列表和卡片类型见:references/kartlar.md。

{"vurgu": ["effort"], "kuyruk": 2.0, "vuruslar": [
  {"duzen": "yuz"},
  {"kelime": "Önce", "kart": {"tur": "liste", "baslik": "Sıra", "isaret": "sayi",
     "maddeler": [{"yazi": "Modeli seç", "kelime": "modeli"}, {"yazi": "Effort'u seç", "kelime": "effort"}]}},
  {"kelime": "oynattım", "ofs": 0.5, "duzen": "grafik", "kart": {"tur": "soru", "soru": "Sen hangisini kullanıyorsun?"}}
]}
  • 拍(Vuruş) = 屏幕的一种状态。kelime 锚点指向词汇的起始位置(例如 "effort" -> "effort'unu"),并从前一个拍之后查找;可以有多个词汇(如 "plan modu"),kac 表示第几次出现,ofs 为偏移秒数。第一个拍从 0 开始。卡片中的项目/行/消息也通过各自的 kelime 进入。
  • 布局: bol(卡片在上,面部在下;这是有卡片的拍的默认布局)、yuz(全屏面部;无卡片时的默认布局)、grafik(全屏卡片,无面部)。
  • 节奏: 每个拍 1.5-4 秒;40 秒的 Reels 中约 10-15 个拍。钩子(前 1-2 秒) 以面部开场。
  • 面部仅出现在说话人看向摄像头的位置。 如果说话人看着屏幕或文字说话,则该拍使用 grafik 布局。
  • 禁止虚构: 卡片仅显示真实说的内容或真实发生的事件。不要写未测量的数字、不存在的命令、虚构的屏幕文字。屏幕截图必须使用用户的真实文件(gorsel)。
  • 结尾: 最后一个拍应使用 soru 卡片(提出一个问题,提示用户在评论区写下答案);说话结束后,屏幕保持 kuyruk(秒)时长(因此选择 grafik 布局,这样在结尾停留期间画面静止)。
  • 字幕中听错的词:使用 "altyazi_duzelt": {"aranaya": "arenaya"}。vurgu 列表中的词汇在字幕中以斜体+强调颜色显示(提供词根即可,如 "effort")。

查看解析后的时间:运行 R vuruslar P(每个拍的开始/结束时间、元素时间;如果某个元素在不可见的情况下切换卡片,会发出警告)。

4. 取景框。

R yuz P          # 面部框估计 -> P/kadraj.json + P/kontrol/kadraj.jpg

使用 Read 打开 kontrol/kadraj.jpg:绿色方框应包围面部(从前额到下巴);蓝色为 bol 布局的裁切框,橙色为 yuz 布局的裁切框。该估计不基于模型(肤色 + 中心优先);背景中接近肤色的表面、多个人物或彩色灯光可能导致错误。如果错误,请根据标尺上的原始像素手动修正 kadraj.json 中的 kutu,然后运行 R yuz P 更新图像(不会覆盖已有的 kadraj.json)。如果人物在移动,则添加 anahtarlar(带时间戳的方框)。

5. 预览,然后渲染。

R kare P                    # 每个拍抽取一帧 -> P/kontrol/kareler.jpg(检查)
R kare P 2.3,31.4           # 特定时刻(入场动画、正在输入的终端)
R render P                  # -> P/cikti/<名称>.mp4,渲染结束后自动运行测量

6. 测量(你无法观看,通过测量数据检查)。 R olc P(渲染结束时自动运行)-> P/kontrol/olcum.md + P/kontrol/temas.jpg:

  • 时长: 视频和音频长度相同,帧数与预期一致。
  • 安全区域: 每隔 5 帧测量一次字幕、卡片和面部的像素框。Instagram 界面覆盖顶部 y<220 区域、底部 20%(y>1536)区域和右侧点赞/评论列(x>940, y 1000-1536);字幕和卡片不得进入这些区域,面部保持在底部 20% 以上。如果出现违规行,则修正剧本(卡片内容、布局)或 kadraj.json。
  • 音频: 最终文件达到 -14 LUFS,真实峰值 <= -1 dBTP;音效轨道比语音低约 15 dB;whoosh 峰值是否对齐到剪辑点。
  • 接触页: 每个拍的卡片填充状态(切换前瞬间)。打开并检查:是否有文字溢出、元素重叠、头部被切、卡片空白。
  • 拼接检查(可选): .venv/bin/python .claude/skills/yatay-kurgu/araclar/kurgu.py dogrula P 重新解析剪辑音频,报告不连贯或泄漏的词汇(P/dogrula.md)。

修正后只需运行 R render P(从头开始渲染音视频,在 M1 Pro 上 40 秒视频约需 35 秒)。

7. 交付。 向用户提供简短的数字报告:输出路径、时长(原始 -> 剪辑)、拍/卡片数量、删除的内容及其理由、安全区域结果、LUFS/峰值、接触页路径。对于无法测量的内容(音频的悦耳度、卡片的清晰度),明确交给用户判断。

已知限制

  • 面部框为无模型估计;每个录制都必须检查 kadraj.jpg。不提供逐帧面部追踪:仅使用固定框或关键帧之间的线性过渡。
  • 从横屏录制中提取的全屏面部(yuz 布局)受限于源的高度:4K 视频中面部可能过大,字幕会自动下移到下巴下方。在 bol 布局中,面部卡片的高度会根据面部下方源图像中剩余的内容缩短(以防止下巴进入底部 20% 区域)。
  • 无背景音乐;音效为合成(whoosh、键盘、嘭、刮擦声)。
  • 卡片类型固定(见 references/kartlar.md)。要添加新类型:在 araclar/kartlar.py 中添加绘制和音效函数,并注册到 CIZ 和 OLAY 字典中。
  • 界面区域(顶部 220 像素、底部 20%、右侧列 x>940)是针对 Instagram Reels 的近似保守值(定义于 araclar/cizim.py 开头);对于 Shorts/TikTok 类似但不完全相同。

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

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

相关技能