这是什么
Remotion Agent Skills 是由 remotion-dev 官方维护的一组 Agent Skills(智能体技能包),旨在为 AI 编程代理(如 Claude Code、Codex、Kimi Code、Cursor 等)提供在 Remotion 项目中的最佳实践指南。通过安装这些技能,AI 代理能够更准确、高效地协助你完成视频创建、渲染、地图动画、字幕制作等一系列任务。

该仓库(remotion-dev/skills)在 GitHub 上拥有 4777 个 Star、535 个 Fork,当前有 22 个开放 Issue,属于活跃维护的官方项目。项目描述为“Agent Skills”,默认主分支为 main,当前提交 SHA 为 a1b09e904a99。
适合谁
如果你正在使用 AI 代理进行视频制作,且希望这些代理能理解 Remotion 的语法、结构和最佳实践,那么这个技能包非常适合你。无论你是独立创作者、开发者,还是需要批量生成视频的内容团队,通过 AI 代理配合 Remotion 技能,都能大幅提升视频生产效率。
此外,该技能包也适合那些刚接触 Remotion、希望用自然语言描述想法后由 AI 生成视频的用户——你只需给出提示词,AI 代理就能依据技能指导完成从创建项目到最终渲染的完整流程。
能做什么
这个仓库包含多个独立但相互关联的技能,每个技能专注于一个具体领域:
- /remotion-best-practices:总览技能,涵盖所有其他技能的最佳实践,不确定用哪个时先用它。
- /remotion-create:创建新的 Remotion 项目或组合,例如“为唱片店制作宣传视频”。
- /remotion-markup:编写 Remotion React 标记的最佳实践,包括动画、布局、排版、媒体元素、特效、音频、字体和时序。
- /remotion-studio:启动 Studio 预览视频。
- /remotion-render:将视频渲染为成片或静态图片。
- /remotion-maps:地图动画最佳实践,支持静态地图、动态路线、标注点、地理讲解、Mapbox、MapLibre、MapTiler、GeoJSON 以及 CesiumJS 3D 地理飞行。
- /remotion-captions:字幕和副标题的转录、显示与动画指导。
- /remotion-saas:基于 Remotion 构建应用与产品集成的架构指导,例如“把视频变成 SaaS”。
- /remotion-interactivity:让 Remotion 代码在 Studio 中可编辑的指导,解决元素不可选中或编辑的问题。
- /remotion-docs:搜索 Remotion 文档并将任意页面抓取为 Markdown,用于查询最新的 API 参考、组件属性和包指南。
- /remotion-upgrade:升级 Remotion、相关包、兼容的 Mediabunny 包以及已安装的 Agent Skills。
- /remotion-multimedia:基于 Mediabunny 处理浏览器多媒体元素的指导,如获取音视频元数据。
使用前准备
你需要在本地安装并配置一个兼容的 AI 代理(如 Claude Code、Codex、Kimi Code 或 Cursor),并具备 Node.js 环境。本技能包本身不要求 API Key,也不需要额外的本地服务,安装后即可直接使用。
安装方法
安装非常简便,只需在终端中执行以下命令:
npx skills add remotion-dev/skills
此外,当你创建新的 Remotion 项目时,也会被提示选择添加技能,命令如下:
bun create video
更详细的文档请参考 Remotion Agent Skills 官方文档。
使用示例
安装后,你可以在 AI 代理的对话中直接调用对应技能,例如:
“
/remotion-createMake a promo video for a record store”
或:
“
/remotion-mapsAnimate a route from Los Angeles to New York and make the camera follow it.”
代理会依据技能内的最佳实践自动生成相关代码,你只需等待结果并进行必要的调整。
风险与注意事项
本仓库由官方维护,但当前未明确标注开源许可证(license 字段为空),使用前请留意授权条款。此外,虽然技能包本身不要求 API Key,但某些操作(如地图动画)可能需要你自行配置第三方服务(Mapbox、MapTiler 等)的密钥。最后,AI 生成代码仍需人工审查,尤其在涉及复杂业务逻辑或生产环境时,建议结合官方文档进行验证。