Aug 27, 2026
remotion-dev/skills:Remotion 视频项目的最佳实践 skill 集
Remotion 团队出品的 12 个 skill 集合,覆盖 React 视频框架的项目脚手架、标记、字幕、地图动画、渲染配置、SaaS、交互和版本升级。
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 集合。