Aug 27, 2026

remotion-dev/skills:Remotion 视频项目的最佳实践 skill 集

Remotion 团队出品的 12 个 skill 集合,覆盖 React 视频框架的项目脚手架、标记、字幕、地图动画、渲染配置、SaaS、交互和版本升级。

#tutorial#skill-creation#creative#developer-tools

Remotion 是基于 React 的视频框架。在 Remotion 项目里做好,意味着要遵守项目特定的约定——标记模式、渲染配置、字幕时序、地图动画——这些并不是通用 React 最佳实践。remotion-dev/skills 把 Remotion 团队自带的 12 个 skill 打包好,让你不必把每一条约定都装在脑子里。

为什么这个 skill 重要

仓库自带 12 个 skill:remotion-best-practices(拿不准用哪个时的大伞 skill)、remotion-create(项目脚手架)、remotion-markup(动画标记模式)、remotion-studio(Studio 调试)、remotion-render(渲染配置)、remotion-maps(地图动画序列)、remotion-captions(字幕时序与样式)、remotion-saas(Remotion SaaS 集成)、remotion-interactivity(交互式视频元素)、remotion-docs(文档检索)、remotion-upgrade(版本迁移)、remotion-multimedia(音视频素材)。README 明确列出的兼容 agent:Claude Code、Codex、Cursor、Kimi Code。

仓库 4.4k 星、71 commits、10 open、11 open PR——还在持续维护。仓库根目录没有 LICENSE 文件;请把"复用权利未明"作为事实信号,在上游澄清之前按这个处理。

安装

标准安装命令对所有支持的 agent 都一致:

npx skills add remotion-dev/skills

如果是新搭一个 Remotion 项目,上游推荐用:

bun create video

按你的项目状态挑一条路径。

真实工作流:用 /remotion-create 搭一条门店宣传片

你想给一家唱片店做一条短宣传片,之前从没搭过 Remotion 项目。remotion-create skill 用一行意图把项目结构搭出来。

第一步。在装好 skill 的 agent(Claude Code、Cursor 或 Codex)里,进一个空目录,跑:

/remotion-create Make a promo video for a record store

第二步。skill 读完请求,搭出一个 Remotion 项目(package.json、src/ 目录树、一个默认 Composition 和一个入口),把"唱片店"的意图灌进 composition 的数据。

第三步。本地打开项目跑开发服务器:

bun install
bun run start

Remotion Studio 在浏览器里打开,能看到实时预览。

第四步。修改 composition,或者让 agent 扩展脚手架(多几个镜头、加时长、换字体)。skill 把"项目骨架"那部分做掉,你专注视觉。

第五步。要发布时,用 remotion-render 把视频导出来——见下一个工作流。

真实工作流:用 /remotion-render 加字幕并导出

你有一个 Remotion 项目,有几个镜头,但视频需要字幕和最终渲染。remotion-captions 负责字幕层;remotion-render 负责导出。

第一步。给项目加字幕:

/remotion-captions Add SRT-style captions to the existing composition using the audio file at public/voiceover.mp3.

skill 读音频、生成字幕时序,用 Remotion 的字幕约定把 Captions 组件写到项目树里。

第二步。在 Remotion Studio 里检查字幕。手工微调任何它搞错的时序。

第三步。导出最终视频:

/remotion-render Render the current composition to out/promo.mp4 at 1080p.

skill 配置好渲染命令、跑完、报告输出路径。如果视频较长,可能会用服务端渲染或分块本地渲染;看 skill 的渲染输出确认实际命令。

第四步。如果要从旧版 Remotion 升级,用 remotion-upgrade 走一遍 breaking changes:

/remotion-upgrade Migrate the project from Remotion 3 to Remotion 4.

skill 读现有代码、识别废弃的 API、把它们替换成最新等价实现,把需要手工审查的模式挑出来。

技巧

  • 拿不准用哪个 skill 时,先用 /remotion-best-practices——README 说它是"大伞"。
  • 全新项目才用 /remotion-create。已有项目先跑 /remotion-upgrade,再跑 /remotion-markup 清理模式。
  • /remotion-captions 默认假设你已经有一条音轨。先录或生成好旁白,字幕是按音轨派生的。
  • 如果你要用 SaaS 渲染 Remotion(Remotion Lambda 之类),把 /remotion-saas/remotion-render 配在一起,先用短样本验证再投入完整渲染。
  • "仓库没有 LICENSE" 是事实信号:在闭源产品里复用这些 skill 文件之前,先找 Remotion 团队要明确的复用许可。

何时不要用

如果你不是在做 Remotion 视频,这些 skill 都不适用。即便在 Remotion 生态里,"大伞" skill remotion-best-practices 会加载大量上下文——如果只要一个特性(比如字幕),就只装 remotion-captions,不要大伞 + 字幕一起装。


leaderboard 查看更多 skill 集合。