Communitygithub.com

Remotion短视频制作技能

指导AI助手规划、构建或剪辑“Remotion短视频”,最终输出完整的视频成品。流程涵盖Remotion短视频技能、0. 设置(每台机器一次)、1. 询问需求(一条消息,跳过已知内容)。当新任务需要此技能时使用。

Remotion短视频制作技能 是什么?

Remotion短视频制作技能是一个专门为AI助手设计的工具,用于通过JSON脚本规划、构建和渲染短视频。它利用Remotion框架自动将文字内容按阅读速度排版到各个场景中,确保文本始终在安全区域内(不被应用按钮遮挡),并生成预览图、封面图和最终的MP4视频文件。该技能支持在macOS、Windows和Linux上运行,需要Node 20或更新版本。它内置了多种视觉主题(如ink、paper、volt等),并提供严格的检查机制,包括场景阅读性、文字长度和节奏控制,确保输出高质量、可发布的短视频。最终视频可通过WoopSocial API发布到TikTok、Reels和YouTube Shorts等平台。整个过程强调信息准确性、来源可追溯和避免重复内容,适合制作基于事实的短视频内容。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SadiTLM/agentic-reels-studio/tree/HEAD/skills/remotion-shorts-skill

在你喜欢的 AI 中提问

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

文档

Remotion短视频制作技能 是做什么的?

您将短视频编写为一个JSON场景文件。打包好的Remotion项目负责文字排版、按阅读速度计时、确保文本不被应用按钮遮挡、渲染预览图、封面图和MP4文件,用户可通过WoopSocial发布。

您无需为每个视频编写Remotion代码。模板是固定且经过测试的;您的工作是编写脚本:每个屏幕显示什么、顺序如何、以及播放速度。

0. 设置(每台机器一次)

需要Node 20或更新版本。用node -v检查;如果没有,引导用户访问https://nodejs.org。Remotion支持macOS 15或更新版本、Windows x64以及带有glibc 2.35+(Ubuntu 22.04、Debian 12或更新版本)的Linux。

node <skill-dir>/scripts/setup.mjs remotion-shorts

该命令会将项目复制到./remotion-shorts目录,安装固定版本的包(约260 MB)并下载Remotion渲染所需的无头浏览器(100至150 MB)。首次运行需要1到3分钟。技能更新后重新运行此命令:它会刷新模板文件(用户已更改的文件会保存为.bak),且不会影响用户的脚本、资源或输出。

许可协议: Remotion对个人和不超过3人的公司免费。4人或以上的公司需要Remotion公司许可证,通过脚本渲染视为自动化(remotion.pro/license)。如果用户是为更大的公司进行渲染,请在首次渲染前明确告知一次。

1. 询问需求(一条消息,跳过已知内容)

  • 素材: 主题、文章、URL、笔记、数据、变更日志或列表。您只能基于可引用的来源编写事实。如果用户提供了没有来源的主题,请查找主要来源(官方数据、文档、产品自己的变更日志)并注明。
  • 目标受众和核心信息: 一个短视频只说一件事。
  • 外观: 一个主题(ink、paper、volt、ocean、clean)或他们的品牌颜色,以及结尾屏幕的账号名称。
  • 音频: 内置音效默认开启(开场音效、场景切换音效、高亮音效、倒计时音效);这些是为本模板制作的,在所有应用上安全。音乐仅限用户拥有使用权的文件(请参阅references/writing-shorts.md了解为什么没有任何免费音乐库在所有三个应用上都是安全的)。
  • 发布平台: TikTok、Reels、Shorts或全部三个。

2. 编写脚本

在每次会话编写第一个脚本之前,请阅读references/writing-shorts.md。简要版本:

  • 场景1是钩子,需在10个单词或更少内陈述核心信息:一个数字、一个主张或列表承诺("5个免费工具替代...")。它必须从第0帧开始完全显示。如果钩子包含数字,请将其放入big字段,使其成为视觉焦点。
  • 每个场景一个想法: 场景是一个节拍,而不是一个段落。统计场景传达一个数字及其含义。列表项按顺序递减或递增;在钩子中说明。
  • 每个场景包含真实信息: 没有新内容的模板化文字视频会被YouTube称为不真实内容,被Instagram称为非原创内容。切勿填充内容。
  • 数字精确且有来源: 在footer中放置来源("数据来源:USGS")。切勿将数字四舍五入从而改变原意。
  • 结尾为一个行动或将观众引回钩子的一句话,使循环感觉连续。不要说 "感谢观看"。
  • 时长: 目标为15到45秒;超过59秒时渲染器会发出警告。

在项目文件夹中编写short.json。完整格式、每种场景类型及所有选项请参阅references/short-json.md。一个最小脚本示例:

{
  "theme": "ink",
  "footer": "数据来源:USGS",
  "handle": "@yourhandle",
  "scenes": [
    { "type": "hook", "big": "2.5%", "text": "的地球水资源是淡水" },
    { "type": "stat", "value": "96.5", "suffix": "%", "label": "是海洋中的盐水" },
    { "type": "stat", "value": "68.7", "suffix": "%", "label": "的淡水以冰和冰川形式存在", "highlight": "冰和冰川" },
    { "type": "end", "text": "保存此视频用于知识竞赛", "highlight": "保存此视频" }
  ]
}

3. 渲染前检查视频

cd remotion-shorts
node render.mjs short.json --stills

此命令会在几秒内打印计划(每场景的秒数和字体大小),并生成:

  • out/short/sheet.jpg:每个场景的最后一帧(所有屏幕内容),安全区域用细虚线标记(文本必须保持在其内部)。
  • out/short/cuts.jpg:第0帧以及每个剪辑点周围的帧,用于检查运动。
  • out/short/cover.jpg:稳定后的钩子画面(可上传为Reels封面)。
  • out/short/report.json:时间、换行和警告信息。

打开这两张图片并仔细查看。 检查:每个场景在手机尺寸下是否可读,每个场景是否只传达一个信息,高亮是否用在关键词语上,是否有任何内容显得局促,顺序是否正确,以及第0帧是否显示了完整的钩子。修正JSON并再次运行--stills,直到您觉得可以发布为止。

警告会阻止视频渲染(退出代码2):一个屏幕文字过长、钩子过长、高亮部分不在文本中、场景阅读速度过快、节奏超出0.85到1.25的范围、或短视频超过59秒。修正脚本;仅在用户已看到警告并仍希望执行时使用--force。某些问题是--force无法覆盖的错误,例如在任何字号下文字宽度都超出屏幕:这些会导致文字显示在屏幕外。

4. 渲染

node render.mjs short.json

生成 out/short/short.mp4:1080x1920,30 fps,H.264,yuv420p,AAC(无音乐时包含静音音轨),TikTok、Reels和Shorts均支持。30秒的短视频在较新的笔记本电脑上渲染约需一分钟。内存为8 GB的机器每次渲染2帧;如果渲染因内存不足而终止,请使用--concurrency 1重新运行。

在展示之前,请选取三帧查看(开始、中间、结束),或者如果您的客户端支持则播放。然后向用户展示封面图、预览图和MP4文件路径。

多个账号: 切勿将同一文件发布到多个账号。为每个账号制作一个变体(不同的钩子、主题或场景顺序,保存为独立的JSON文件),以确保没有两个账号发布近似重复的内容。

5. 发布(WoopSocial,需确认)

阅读references/woopsocial.md。简而言之:

  1. 使用social_accounts_list查找账号(如有需要先连接)。
  2. 对于TikTok,使用social_accounts_get_platform_inputs获取该账号的隐私选项和允许的最大视频时长。用户选择隐私设置;没有默认值。
  3. 上传:使用media_uploads_create_session并传入report.json中的精确字节大小,将响应保存为session.json,运行node upload.mjs session.json out/short/short.mp4,然后执行media_uploads_complete_session直到状态变为READY。
  4. 为每个平台编写文案(TikTok和Reels:一行补充视频内容的文字加3到5个具体话题标签;YouTube:100字符以内的标题加描述)。使用contentOverride为每个平台设置不同的文本。
  5. 使用posts_validate验证,然后向用户展示:账号、各平台文案、隐私设置、计划时间(含时区)、封面图。等待明确的确认。然后执行posts_create和posts_get。

披露字段:当短视频推广用户自己的产品时,在TikTok上设置isYourBrand: true;仅当涉及逼真的AI图像、视频或语音时才设置isAiGeneratedContent(动态文字不需要)。YouTube的madeForKids是法律声明:必须询问,切勿猜测。

6. 反馈报告

展示:MP4路径、时长、预览图、发布位置(来自posts_get的链接)或计划时间,以及任何无法完成的任务。切勿捏造观看量或结果;稍后使用social_account_posts_list读取,并报告数据收集的日期。

编辑外观

  • 品牌颜色: 将theme参数设为对象(bg、fg、accent、accentText、font、uppercase)。保持文本对比度不低于7:1;同时检查强调色在背景上的对比度。
  • 场景背后的照片或视频: 使用image(每个场景)或background(整个短视频)。它们会在主题颜色下调暗,以确保文本可读。使用用户拥有或获得许可的文件,并在许可要求时在文案中注明来源。
  • 内置字体: Anton(紧凑、大写、醒目)、Poppins、Inter。均为OFL许可。
  • 更改模板: 编辑src/Short.tsx,并使用npm run studio预览。

边缘情况

  • 数字无来源: 不要使用。说明缺失的内容。
  • 文字无法容纳: 拆分场景;不要将字体缩小到最低限制以下(渲染器不会允许)。
  • 从右到左文字、CJK文字或表情符号: 内置字体不支持,可能显示为空白框。请说明并避免使用(表情符号可放在文案中)。
  • 用户想要热门音效: API发布无法添加。通过postMode: MEDIA_UPLOAD发布到TikTok,使其进入用户TikTok收件箱,以便在应用内完成编辑。
  • Linux上渲染失败(缺少库):安装references/platform-specs.md中列出的包。
  • Windows: 始终在JSON文件中传递参数,切勿内联在命令行中。

质量标准

在宣布完成之前,应满足以下所有条件:

  • 第0帧显示完整的钩子(检查cuts.jpg);约10个单词或更少,说明核心信息。
  • 每个场景只说一件事;每个场景不超过约14个单词。
  • 每个数字与其来源匹配;来源在屏幕上或文案中。
  • 无警告,或用户已看到警告并选择了--force。
  • 已检查两张预览图:文本未超出虚线安全线,高亮在正确的词语上。
  • 时长在15到59秒之间。
  • 为每个账号创建了不同的版本。
  • 用户在发布前已确认。

相关技能