1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | remotion-markup-remotion-dev-skills |
| 作者/维护者 | Remotion（remotion-dev 官方团队，视频框架 Remotion 的所有者） |
| 来源链接 | https://github.com/remotion-dev/skills/tree/main/skills/remotion-markup |
| 许可证 | Remotion License（个人与小型公司可免费使用，达一定规模的商业机构需付费授权），GitHub API 未能自动识别为标准 SPDX 许可证，已直接读取仓库 LICENSE.md 确认条款 |
| GitHub Stars | 4,204（合集仓库 remotion-dev/skills 整体数字，来自 GitHub API；该数字属整个技能合集，不代表本技能自身热度） |
| Forks | 484（同上，合集整体） |
| 最新版本 | 4.0.506（SKILL.md frontmatter 标注，随 Remotion 框架版本同步发布） |
| 安装方式 | 见第 10 章 |
2. 功能介绍与亮点
remotion-markup 是 Remotion（用 React 编写、渲染为 MP4 视频的开源框架）官方技能合集中专门负责“如何写视频动画与特效”的一份实践指南：
- 动画驱动方式：明确规定用
useCurrentFrame()+interpolate()驱动动画，指出 CSStransition/animation与 Tailwind 动画类在 Remotion 渲染环境下不生效，需要重构；并给出Easing.bezier()、Easing.spring()等缓动函数的用法。 - 可编辑优先的写法约定：要求把
interpolate()内联写在style属性里、优先使用scale/translate/rotate而非transform字符串拼接，目的是让动画参数在 Remotion Studio 里可视化可编辑。 - 媒体元素全覆盖：
<Video>、<Audio>、<CanvasImage>、<AnimatedImage>等组件的用法、staticFile()引用本地资源与远程 URL 的区别。 - 全场景参考文档：仓库内该技能目录共 32 个文件，除主文档外还有专门覆盖字幕高亮、多场景视频、AI 配音（ElevenLabs）、视频/音频裁剪与嵌入、转场、3D 内容（Three.js/React Three Fiber）、音效、音频可视化、Google/本地字体、GIF、Lottie 动画、文本测量、FFmpeg 静音检测等 20 余个细分主题的独立参考文件。
亮点：官方 Remotion 团队直接出品并持续维护；该技能目录近 5 次提交横跨 2026-07-30 至 2026-08-04，几乎每日更新一次；技能采用真实项目代码示例而非伪代码。
3. 适用场景
所属分类：内容创作与知识管理（该技能的产出物是视频动画与特效内容本身的编写规范，服务于视频内容创作实践，而非通用前端界面搭建）。
适用人群：使用 Remotion 编写程序化视频的开发者与内容团队——当需要为视频添加淡入淡出、位移缩放旋转、逐帧关键帧动画、地图动画、音频可视化或 3D 特效等具体效果时，用它查到符合 Remotion 渲染引擎与 Studio 可编辑约定的标准写法。
4. 跨 Agent 兼容性
| Agent 生态 | 结论 | 依据 |
|---|---|---|
| Claude Code | 原生支持 | 仓库 README 将 Claude Code 列为受支持 agent，技能以 /remotion-markup 斜杠命令触发，遵循标准 SKILL.md 格式 |
| Codex | 原生支持 | 仓库 README 同样将 Codex 列为受支持 agent，可通过同一套 npx skills add 安装 |
| OpenClaw | 未验证 | 已抓取材料（仓库 README、SKILL.md）未提及 OpenClaw |
| Hermes Agent | 未验证 | 已抓取材料未提及 Hermes Agent |
5. 推荐理由
程序化视频最容易踩坑的地方不是“会不会写 React”，而是不知道 Remotion 渲染引擎的隐藏约束——CSS 动画/Tailwind 动画类在这里悄悄失效、transform 字符串拼接会让参数在 Studio 里变得不可编辑。remotion-markup 把这些约束和推荐写法整理成一份持续更新的实践指南，配合 20 余个细分主题的参考文档（地图动画、音频可视化、3D、字幕高亮等），能让开发者一次性按官方约定把动画写对，减少渲染出错或后期返工。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 官方 Remotion 团队直接出品；Remotion 核心框架自身在 GitHub 拥有 5.5 万+星，是程序化视频生成领域的主流开源工具，“用 AI agent 写 Remotion 视频”在 2026 年已形成社区热度（Reddit、Hacker News 等平台均有独立讨论）；合集仓库 4,204 星未计入本分 |
| 可用性 | 9 | 32 个高度结构化的参考文件覆盖动画、媒体、字幕、音频、3D、地图等几乎全部创作场景，代码示例可直接运行；该技能目录近 5 次提交横跨最近 5 天、几乎每日更新，维护极活跃；个人与小型团队使用免费，无强制付费依赖 |
| 安全性 | 9 | 内容为纯技术写作指导与代码示例，未发现可疑指令；涉及的命令行操作（npx remotion studio、npx remotion still）均为项目本地开发工具，用途透明可审计，不涉及外部网络请求或凭据索取 |
安全检查清单： ① 是否执行 shell 命令：技能引导的命令均为 Remotion 项目本地开发命令（启动预览、渲染单帧），范围明确，不涉及系统级操作 ② 运行时是否联网外发数据：技能本身不发起任何网络请求；文档提及的远程视频/音频 URL 是用户自行提供的素材地址，非技能主动外发 ③ 是否要求 API key/凭据：核心内容不需要；文档中语音生成相关的可选章节提及 ElevenLabs 第三方语音合成服务，为可选功能而非必需依赖 ④ 可疑指令：未发现 ⑤ 作者/组织信誉：Remotion 官方团队，公开身份明确，无刷星或造假迹象 ⑥ License：Remotion License，条款明确（个人/小型公司免费，规模企业需付费） ⑦ 最近维护时间：该技能目录最近提交为 2026-08-04，在近 3 个月维护窗口内且频率极高
7. 跟同类 Skills 相比的优势
| 竞品 | 定位 | 与本技能的差异 |
|---|---|---|
同合集的 remotion-best-practices |
Remotion 项目的通用入门与整体规范，官方建议“不确定用哪个技能时先看这个” | 是覆盖全局的入口技能，对动画细节、缓动曲线、媒体元素等具体写法未展开；remotion-markup 专注这部分的深度实践指导 |
| hyperframes（heygen-com） | 开源 HTML 转视频框架，让 agent 像写网页一样直接产出可渲染 MP4 | 走 HTML/CSS 技术路线，面向快速产出宣传片/讲解短片；remotion-markup 走 React/Remotion 技术栈，面向逐帧关键帧级别的精细动画控制与专业时间轴合成，覆盖 3D、地图动画、音频可视化等更深的定制场景 |
8. 用户评价
该技能目前在第三方平台尚无经核实的具名用户评价。第三方技能目录站点标注了使用量与评分等聚合数字，但未提供可核实的具名评价来源，故未采用。
9. 其他补充
remotion-markup 与同仓库的 remotion-interactivity（Studio 内可编辑元素指南）、remotion-maps（地图动画）、remotion-captions（字幕）等技能相互引用、职责分工明确，显示这是一套架构统一、持续演进的官方技能矩阵，而非零散拼凑的文档集合。
10. 安装使用方式
- 手动复制（推荐）：将
remotion-dev/skills仓库中skills/remotion-markup/目录克隆或下载后，复制到 Claude Code / Codex 的技能目录（如.claude/skills/remotion-markup/） - 官方一键安装：运行
npx skills add remotion-dev/skills安装整套 Remotion 技能合集（含本技能），或在新建 Remotion 项目时运行bun create video并按提示选择安装技能 - 安装后注意事项：安装后无需重启 agent；在涉及 Remotion 动画、特效、媒体元素编写的对话中会被自动匹配，也可用
/remotion-markup显式触发；使用前需已有可运行的 Remotion 项目环境（Node.js + Remotion 依赖）
11. 注意事项
- Remotion License 为个人/小型公司免费、达一定规模的商业机构需付费授权的双层许可，不是完全宽松的开源许可证，企业用户使用前应自行核实是否需要购买商业授权
- 官方一键安装命令
npx skills add所依赖的第三方安装器vercel-labs/skills存在两个尚未修复的公开 issue，分别指控其在未明确告知的情况下上传使用数据、以及审计上报机制不完全受禁用开关约束；选择该安装路径的用户可改用上文的手动复制方式规避此风险 - 合集仓库整体 4,204 星与 484 forks 属整个 remotion-dev/skills 技能矩阵，不代表本技能自身的独立采用热度
- 该技能高度绑定 Remotion 框架本身，不能脱离 Remotion 项目单独使用