1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | video-shotcraft |
| 作者/维护者 | Wei Yihao（GitHub: Vincentwei1021） |
| 来源链接 | https://github.com/Vincentwei1021/video-shotcraft |
| 许可证 | Apache License 2.0 |
| GitHub Stars | 413（GitHub API 数据） |
| Forks | 30（GitHub API 数据） |
| 最新版本 | 未发布正式 Release/Tag，随 main 分支持续更新 |
| 安装方式 | 自然语言安装 / npx skills add / git clone 后软链接到 skills 目录 |
2. 功能介绍与亮点
video-shotcraft 把 Claude Code / Codex 变成一个“电影感产品视频制作工作室”，围绕 Remotion 框架实现分镜、动效与声音设计的全流程自动化。
- 106 张镜头配方卡：含用途、能量曲线、建议时长、实现要点与已知坑，并配可运行的 Remotion（TSX）实现源码。
- 161 个动效样片，覆盖 162 种视觉风格，可在配套 Gallery 网页在线搜索预览。
- 内置完整宣传片模板“Ink Press”：36.2 秒、1080p、10 个镜头，含 2.5D 真实页面运镜、字卡、转场与电影感音效，替换素材即可复用。
- 六阶段生产方法论：采集 → 视觉语言提取 → 分镜 → 实现 → 声音设计 → 验收，交付前要求独立上下文的 subagent 做逐帧视觉质检。
- BGM 节拍卡点：定位真实 BPM/相位，切点误差回测 ≤3 帧；渲染采用确定性伪随机，保证逐帧可复现。
3. 适用场景
所属分类：内容创作与知识管理。
适合需要制作产品宣传片、发布视频、功能演示视频或品牌短片的独立开发者、初创团队与内容创作者——尤其是没有专业动效/剪辑背景，但希望产出媲美一线科技公司官方宣传片质感的用户。也适合只想抽取单个动效镜头（如卡片飞入、聚光推近）用于其他视频项目的场景。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——README/SKILL.md 明确给出
~/.claude/skills/安装路径与调用示例。 - Codex：✅ 原生支持——README/SKILL.md 明确给出
~/.codex/skills/安装路径，且全文以“Claude Code / Codex”并列描述。 - OpenClaw：❓ 未验证——现有文档未提及，采用标准 SKILL.md 格式，理论上具备兼容基础，但缺乏直接证据。
- Hermes Agent：❓ 未验证——同上，现有文档未出现相关信息。
5. 推荐理由
video-shotcraft 把“做一支像官方宣传片”这件事，从需要专业动效师的门槛，压缩成了“选一张镜头卡+替换素材”的对话式操作。106 张卡片背后是对 ClickUp、Perplexity、Notion、Figma 等一线产品官方宣传片运镜手法的系统性拆解与 Remotion 复现，每张卡都附带真实调校过的实现代码，这是它与通用“AI 编程做视频”工具最大的差异；节拍卡点、确定性渲染、独立视觉审查等方法论细节也体现出少见的工程严谨度。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 6 | GitHub 413 星、30 Fork，项目创建仅 3 天但增长明显；因过于新，尚未检索到独立第三方讨论来源 |
| 可用性 | 8 | 自然语言安装 / npx skills add / 手动软链接三种途径均清晰；SKILL.md、中英双语 README 及六份方法论文档完整；近日仍在活跃提交；需本地配置 Node.js、Remotion 与 ffmpeg 环境 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：
① Shell 命令：执行本地 Remotion 渲染与本地开发服务器的无头浏览器截图，范围限定在用户自己的产品页面，用途明确 ② 联网外发：无——截图对象为本地 dev server，不涉及外部数据上传 ③ API key/凭据：不需要 ④ 可疑指令：通读 SKILL.md、README 全文未发现 prompt injection 或隐蔽指令迹象 ⑤ 作者信誉：GitHub 账号 2016 年注册的十年老账号，无刷星/SEO 操纵措辞迹象 ⑥ License：Apache License 2.0，明确 ⑦ 最近维护：近期（2026-07-21）有提交记录
综合评分（三项均值）≈ 7.3
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 与 video-shotcraft 的差异 |
|---|---|---|
| video-shotcraft | 镜头卡+验收模板驱动的电影感产品宣传片制作 | — |
| remotion-best-practices（Remotion 官方技能） | Remotion 框架通用编码规范与最佳实践指导 | 教 Agent“怎么写好 Remotion 代码”，不提供具体镜头模板或成片方案，属底层框架规范类工具 |
| remotion-video-skill（wshuyi） | 用 Remotion 做程序化视频的通用工具型技能，支持 AI 语音合成，面向教程、数据可视化、音乐可视化 | 无预设镜头库或模板，视频内容需用户自行编程定义，覆盖场景更泛化，但不聚焦“电影感产品宣传片”这一具体质感 |
| pixel2motion | 把静态 Logo 栅格图转成流畅 SVG 动效动画 | 聚焦 Logo 单一动效场景，不涉及完整宣传片分镜、声音设计与真实页面运镜 |
8. 用户评价
该技能发布仅 3 天，目前尚未在第三方平台检索到具名用户评价。
9. 其他补充
提供中英双语 README；素材授权与致谢中列出参考对象（ClickUp、Perplexity、Notion、Figma、Raycast 等官方宣传片），并声明未使用其画面或品牌素材，仅复现运镜手法；音频资产附带独立 ATTRIBUTION.md 授权说明。
10. 安装使用方式
方式一：把仓库链接交给 Agent，让其自动 clone 并链入 skills 目录：
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft方式二：使用 skills.sh CLI：
npx skills add Vincentwei1021/video-shotcraft方式三：手动安装：
git clone https://github.com/Vincentwei1021/video-shotcraft.git
cd video-shotcraft
ln -s "$(pwd)" ~/.claude/skills/video-shotcraft # Claude Code
# 或
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex安装后无需重启，对话中说“用 video-shotcraft 做一个产品宣传片”即可触发；渲染阶段需本机安装 Node.js（≥18）与 Remotion 依赖，首次使用建议先跑通内置模板“Ink Press”再定制。
11. 注意事项
- 首次使用前需在本地环境安装 Node.js 与 Remotion 相关依赖，纯云端、无本地开发环境的用户可能需要额外配置成本
- 模板自带的产品截图为演示素材，正式使用前需替换为真实产品截图，并自行确认是否需要脱敏
- 项目上线仅 3 天，长期维护稳定性与后续版本兼容性仍有待观察
- OpenClaw、Hermes Agent 上的兼容性未经验证