1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Remotion Captions |
| 作者/维护者 | Remotion 官方团队(remotion-dev) |
| 来源链接 | https://github.com/remotion-dev/skills/tree/main/skills/remotion-captions |
| 许可证 | Remotion License——双层许可:个人、≤3 人的营利性组织、非营利组织可免费商用;规模更大的营利性企业需购买商业授权(GitHub API 未识别为标准 SPDX 许可证,已读取原文确认条款清晰) |
| GitHub Stars | 所属 remotion-dev/skills 技能合集整体 4,180 星、481 fork(GitHub API);该数字属整个合集,不代表本技能自身热度 |
| 最新版本 | 4.0.504,与 Remotion 主框架版本号同步 |
| 安装方式 | npx skills add remotion-dev/skills,或在 bun create video 脚手架流程中勾选安装 |
2. 功能介绍与亮点
Remotion Captions 是 Remotion 官方 Agent Skills 合集中专门负责字幕/字幕条场景的技能,教会编码 Agent 在 Remotion 视频项目里完成“转录 → 展示 → 导入”这一条完整的字幕工作流。
核心能力:
- 本地语音转录:基于
@remotion/install-whisper-cpp包,在本地下载并运行 Whisper.cpp 模型,把音频转成带逐词时间戳的字幕 JSON,无需注册账号或调用付费云端语音识别 API - TikTok 风格动态字幕:通过
createTikTokStyleCaptions()把字幕按可配置的时间窗口分页,支持逐词高亮显示,贴合当下短视频的字幕呈现习惯 - SRT 字幕导入:已有
.srt字幕文件时可直接导入并转换为技能统一的Caption类型,无需重新转录 - 三份职责单一的分步指南(转录、展示、导入)分文件组织,Agent 按需加载对应文件即可,不必一次性读完整份文档
- 与同仓库的
remotion-best-practices等其他 Remotion 官方技能共享同一套项目规范和版本号,跟随 Remotion 主框架同步更新
3. 适用场景
所属分类:内容创作与知识管理
适合用 Remotion(基于 React 的程序化视频框架)制作内容的开发者与内容创作者:给已录制或 AI 生成的口播视频自动转录并添加字幕;为短视频平台内容制作逐词高亮的动态字幕;把已有的 .srt 字幕文件导入并展示进 Remotion 合成的视频里。
4. 跨 Agent 兼容性
- Claude Code:原生支持——官方文档与仓库 README 明确列出支持 Claude Code
- Codex:原生支持——官方文档与仓库 README 同样明确列出支持 Codex
- OpenClaw:未验证——官方材料未点名 OpenClaw,SKILL.md 遵循标准 Agent Skills 格式,理论上可手动安装,但未见官方确认
- Hermes Agent:未验证——官方材料未提及
5. 推荐理由
由 Remotion 官方团队维护,把“给视频加字幕”这件事拆成转录、展示、导入三个职责清晰的子指南,本地 Whisper.cpp 转录不依赖任何付费云端语音识别服务,配合 TikTok 风格逐词高亮,覆盖了程序化视频制作中最高频的字幕需求。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 出品方 Remotion 主框架 GitHub 55,000+ 星,是知名度很高的程序化视频框架;专属 Agent Skills 仓库整体 4,180 星/481 fork(数字属整个技能合集);仓库 issue 区可见十余位不同独立开发者近期提交的文档修正、功能建议与收录请求,显示真实活跃的社区参与 |
| 可用性 | 9 | 安装为一条命令或项目脚手架内置选项;转录/展示/导入三份指南分工明确、含可运行代码示例;语音转录使用本地 Whisper.cpp 模型,无需注册账号或付费 API;仓库近日仍有提交,随 Remotion 主框架持续维护 |
| 安全性 | 9 | 见下方检查清单,整体纯文档指导 + 透明的本地工具调用,未发现风险信号 |
安全检查清单:
① 权限范围:涉及的 shell 命令(npx remotion add、下载 Whisper.cpp 模型)用途单一明确,均在本地项目目录内操作
② 联网外发:语音转录在本地运行 Whisper.cpp,音频本身不上传第三方服务器;仅下载开源模型文件产生网络请求,过程透明
③ 凭据处理:无需注册账号或 API key,不涉及任何凭据存储
④ 可疑指令:逐份检查 SKILL.md 及三份细分指南,未发现提示词注入或混淆代码迹象
⑤ 作者信誉:Remotion 为知名开源视频框架官方团队,主仓库 55,000+ 星,无造假迹象
⑥ License:条款完整公开可查,但并非标准无限制开源许可(大规模营利企业需另购商业授权),故不打满分
⑦ 最近维护:仓库最近一次提交在最近一天内,版本号随主框架持续迭代
综合评分 = 三项均值 ≈ 8.67
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与 Remotion Captions 的差异 |
|---|---|---|
| remotion-best-practices(同仓库) | 覆盖动画、音频、图表、字幕等全领域的入门级综合指南 | 定位是“不确定用哪个技能时的总入口”,字幕相关内容只是其中一小节;Remotion Captions 专注字幕场景,转录/展示/导入三个子指南更细致完整 |
| haidrrrry/claude-remotion-skill(约 20★,MIT) | 独立开发者制作的 Remotion 视频编辑技能,覆盖 B-roll、字幕、音效等多个环节 | 字幕只是其众多功能之一,未见针对字幕的专门分步文档;不是 Remotion 官方出品,版本更新不跟随主框架 |
| s1dashu/animated-voiceover(约 357★,MIT) | 用 Seedance 等生成式视频模型 + 角色参考图产出动画解说视频 | 技术路线完全不同:不写 React 代码,而是通过第三方付费 CLI(LibTV)驱动生成式视频模型;不涉及给已有素材做字幕转录/导入 |
8. 用户评价
该技能目前在第三方平台尚无针对“字幕”场景本身的具名用户评价;其所属的 remotion-dev/skills 官方技能合集在 GitHub issue 区有十余位不同的独立开发者提交过文档修正、功能建议或收录请求。
9. 其他补充
remotion-dev/skills 仓库由 Remotion 主框架仓库(remotion-dev/remotion)的 packages/skills 目录同步生成并独立发布,版本号与 Remotion 主框架保持一致(当前 4.0.504),跟随主框架每次发版更新。
10. 安装使用方式
方式一:CLI 一键安装(推荐)
npx skills add remotion-dev/skills
方式二:新建项目时勾选
bun create video
脚手架流程会询问是否顺带安装 Remotion Agent Skills。
方式三:手动复制
git clone https://github.com/remotion-dev/skills.git
# 将 skills/remotion-captions 目录复制进你的 Agent 技能目录
安装完成后,在已有 Remotion 项目里用自然语言提出字幕相关需求即可触发,例如:「给这段视频转录并加上 TikTok 风格的逐词高亮字幕」,或直接调用 /remotion-captions。首次使用转录功能时,Agent 会引导安装 @remotion/install-whisper-cpp 并下载 Whisper 模型文件,视网络与设备性能可能需要一些时间。
11. 注意事项
- 该技能假定已存在或新建一个 Remotion 项目作为运行环境,无法脱离 Remotion 技术栈单独使用
- License 为 Remotion 自有的双层许可(个人/小微营利组织/非营利组织可免费商用;规模较大的营利性企业需购买商业授权),使用前建议确认自身所属层级
- 本地语音转录依赖下载 Whisper.cpp 模型文件,首次使用需要一定磁盘空间与下载时间
- 官方文档目前未点名 OpenClaw、Hermes Agent 的兼容情况