Communitygithub.com

原始视频转Reel

将原始讲话视频(印地英语或英语,竖屏9:16)自动剪辑成Instagram Reel,支持静音裁剪、推拉变焦、3D标题、终端面板、漏光效果、音效和关注卡片。

原始视频转Reel 是什么?

该技能可以将用户提供的原始讲话视频(Hinglish或英语,竖屏9:16)自动剪辑成精美的Instagram Reel。它基于Remotion框架,实现了静音裁剪、推拉变焦、3D标题、终端面板、漏光效果、音效和关注卡片等专业编辑功能。技能在macOS和Linux/Windows WSL上均可运行,并提供了完整的脚本化工作流程:从创建项目、转录、静音裁剪、节拍表编写到最终的视觉和音效检查。它严格遵循一套安全规则,确保面部不被遮挡,所有覆盖元素都基于时间码精确同步,并且不会在未经用户许可的情况下下载任何资源。该系统已在多个实例上验证,并内置了Duolingo风格的UI组件库。

兼容平台✓Claude Code~Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/pawantekchandani/reel-from-raw/tree/HEAD/skills/reel-from-raw

在你喜欢的 AI 中提问

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

文档

原始视频转Reel 是做什么的?

已在两个Reel上验证:Linux Day 2 和 Linux Day 1(带音效)。library/Reel.tsx 是 Day 1 的Reel示例。请复制其模式,不要发明新风格。

适用于 macOS 以及 Linux / Windows WSL。设置方法见仓库中的 README.md。

硬性规则

  1. 每个覆盖元素的时间均以 work/words.txt 中的秒数为准。绝不猜测时间。
  2. 仅使用 src/(library)中的组件。仅当库中没有组件能匹配某个节拍时,才添加新组件。
  3. 保持面部清晰。安全区域(1080x1920):
    • 顶部标签和标题:y 90 至 400。
    • 面部和颈部:y 约 450 至 1350。此处除全屏标题卡片(最长3秒)外,不放其他内容。
    • 其他所有内容放在颈部以下(衬衫第一颗纽扣):y 1360 至 1880。Panel 从 BELOW_NECK(1360)处开始。使用 fit 缩放较高的面板,使其在1880处结束。
    • 为每个新视频找到颈线:抓取一帧并观察y轴网格。在 ui.tsx 中更新 BELOW_NECK。
  4. 除非用户在聊天中要求,否则不要渲染完整视频。使用 scripts/stills.sh 进行检查。Hook会阻止没有 RENDER_OK=1 的 remotion render 命令。
  5. 未经用户同意,不要下载任何内容(模型、字体、音乐、音效包)。
  6. 在调试之前,先阅读 reference/known-problems.md。
  7. 在 OpenCode 中,插件 ~/.config/opencode/plugins/reel-from-raw 执行与 Claude hooks 相同的工作(渲染阻止、类型检查、静帧提醒)。使用读取工具打开图表图像。如果您的模型无法看到图像,请让用户检查图表。

范围规则(严格遵守)

  1. 只做用户要求的事情。只修改请求所需的文件和值。
  2. 检查(类型检查、静帧检查、来自hook或插件的提醒)仅仅是检查。只修复违反此文件或 reference/style-spec.md 中规则的问题。绝不要因为检查而重新设计样式、添加组件、添加场景、或更改文本、时间或音量。
  3. 如果您认为还有其他内容需要更改,请用一行告知用户。不要擅自更改。
  4. 在处理视频时,不要编辑 ~/.claude/skills/reel-from-raw/(此技能目录)。只编辑视频项目。
  5. 您创建的测试文件(例如 src/__probe.ts)必须在完成前删除。

工作流程(新视频)

执行每个步骤。每个脚本在成功时会打印 OK:。如果出现 ERROR,则停止并修复。

#步骤命令 / 操作
1创建项目bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4>(例如 ~/Coding/motion-videos/<name>)。它将复制库、声音文件和hooks,并安装npm包(或从 $REEL_SEED 克隆)。
2转录bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi(仅英文则使用 en)。然后使用 reference/glossary.md 修正听错的内容。
3静音裁剪python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>。使用 --start/--end 去除错误的开头或结尾。
4节拍表遵循 reference/beat-sheet-prompt.md。编写 work/beats.md。如果用户希望批准计划,则向其展示。
5构建src/Reel.tsx 是 Day 1 的Reel。根据节拍表重写它。在 Root.tsx 中,设置 id(例如 LinuxDay3)和真实的 handle。删除Reel不使用的场景组件。保留 At 和 r() 辅助函数。
6类型检查自动:hook在每次编辑后运行 tsc --noEmit。修复它报告的每个错误。
7视觉检查bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto,然后读取 out/stills/sheet*.jpg 中的每个文件。还要检查节拍帧:stills.sh <dir> 120,450,...。对照 reference/style-spec.md 进行检查。修复并重复。
8音效检查音效随组件提供(见“音效”)。检查 public/sfx/typing.wav 和 public/sfx/pop.wav 是否存在。除非用户要求,否则不要添加表格之外的声音。
9预览在项目中添加一个 launch.json 条目,运行 npx remotion studio --no-open --port <free>。向用户提供 URL http://localhost:<port>。用户可以在那里听声音。
10渲染(仅按需)RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle(后台运行,90秒视频约需3-5分钟)。

音效

src/sfx.tsx 保存所有声音。SFX 列出所有声音。<Sfx src at volume frames name> 在当前 Sequence 的指定帧播放一个声音。

SFX 中的键来源是否需要网络
whoosh、ding、click、switch、whip@remotion/sfx(remotion.media 上的文件)是,Studio和渲染都需要
poppublic/sfx/pop.wav(由代码生成)否
typingpublic/sfx/typing.wav(由 scripts/make-typing-sound.py 生成)否

库组件已播放这些声音。您不需要手动添加。

时刻文件(在项目中)声音音量
Hook标题 / 子芯片scenes/Intro.tsx(Hook)whoosh / whip0.54 / 0.48
白天标题卡片scenes/Intro.tsx(DayTitle)whoosh / ding0.6 / 0.36
命令列表芯片scenes/Intro.tsx(CommandList)每个芯片 pop0.36
命令标签 / 命令名称scenes/Commands.tsx(CommandTag)whoosh / switch0.54 / 0.48
记事本行scenes/Commands.tsx(NoteCard)每行 typing0.6
下方面板出现ui.tsx(Panel)pop0.48
终端命令输入ui.tsx(Terminal)每行命令 typing0.6
漏光Reel.tsxwhoosh0.48
完成徽章 / 关注点击scenes/Outro.tsx(DayDone、FollowCard)ding / click0.48 / 0.72
任何未指定 volume 的 <Sfx>sfx.tsx(默认)-0.42

音量范围从0(无声)到1(最大)。保持所有声音低于人声。

常见请求(精确配方)

用户要求请精确执行此操作
“将所有音效增加/减少N%”将 <Sfx 行中的每个 volume={x} 以及 sfx.tsx 中的默认值,乘以 (1 ± N/100)。四舍五入到两位小数。不要触碰 CutVideo.tsx(那是人声)。在修改前后运行 grep -rn "<Sfx" src,并显示更改后的值。
“仅更改键盘/打字声音音量”仅更改包含 src={SFX.typing} 的行(ui.tsx 中的 Terminal 和 scenes/Commands.tsx 中的 NoteCard)。
“仅更改声音 X”在上表中找到其所在行。仅更改该 volume。
“键盘声音太弱/制作一个新的”python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav。首先保留旧文件的副本。仅当用户要求不同的感觉时,才编辑脚本中的数字。
“移除一个声音”删除那一行 <Sfx .../>。
“渲染前在哪里能听到?”Studio(步骤9)。按播放或空格键。Studio每次保存编辑后会自动重新加载。
“如何自己渲染?”终端:cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle。Studio UI:渲染按钮(时间轴上方栏的右端)→ 视频选项卡 → 设置输出名称 → 渲染视频。进度显示在作业选项卡中。OpenGL 设置已设置为 angle。
“进行渲染”步骤10,带上 RENDER_OK=1。然后给出输出文件的完整路径。
“更改 handle”Root.tsx 中的 defaultProps.handle。

时间运作方式

  • src/timeline.ts:CUTS(已移除的原始秒数),out(sec) 将原始秒映射到输出帧。
  • <At from={rawSec} to={rawSec} name="..."> 显示该口语时间段的块。
  • r(t0, t) 给出块内的帧延迟,用于“当单词t被说出时弹出此内容”。
  • CutVideo 在每个片段上交替缩放 1.0 / 1.14(每次裁剪时推入)。不要添加更多缩放。

库映射

文件导出用途
theme.tsDISPLAY(Anton)、SANS(Inter)、MONO、颜色 C、extrude()所有文本和颜色。没有新字体或颜色。
sfx.tsxSFX、Sfx音效(见上文)
ui.tsxPop、useIn、useOut、BELOW_NECK、Panel、TermFrame、Terminal弹簧弹入、下半部分面板、打字终端
scenes/Intro.tsxHook({title, sub, subAt})、DailyStep({children})、DayTitle({day})、CommandList({commands, line, lineAt})、LightLeak开场、段落过渡
scenes/Commands.tsxCommandTag({n, total, name, nameAt, meaning, meaningAt, color})、FolderPath、FileGrid、MoveSwap、NoteCard每个段落一个主题:顶部的标签,Panel 中的可视化内容
scenes/Commands.tsx(Day 2,硬编码文本)IdCard、OwnerSwap、PhoneApps、Snapshot、TopView、PdfSearch在重用前为文本添加 props
scenes/Outro.tsxDayDone({day})、NextDay({day, commands, at})、FollowCard({handle})结尾(NextDay 可选)
Reel.tsxReel完整的 Day 1 Reel。将其作为结构示例。

更改文本时保持尺寸、颜色和动画。

相关技能