产品做出来了，需要一个能拿出手的宣传视频。传统路径是找设计师用 AE/Pr 手搓，或者用模板网站套一个--前者贵且慢，后者千篇一律。video-shotcraft 给了第三条路：它是一个 agent 技能，装进 Claude Code 或 Codex 后，你指一下产品，它自己分镜、动画、配音效，用 Remotion 渲出一条电影感的产品 promo。
它是什么
video-shotcraft（github.com/Vincentwei1021/video-shotcraft）是开发者 Vincentwei1021（Yihao）的开源项目，GitHub 星 3492，fork 295，主语言 TypeScript，Apache-2.0 许可证，2026-07-19 创建，最近一次 push 就在今天（8 月 4 日）。一句话定位：把 Claude Code 或 Codex 变成一个 motion-design studio，指向你的产品，它分镜、动画、配音效，用 Remotion 渲出电影感的 promo、marketing、launch 或 demo 视频。
它和 book-to-skill 同属「agent skill」这一波--遵循开放 Agent Skills 标准，装进 agent 的技能目录，agent 按需调用。但方向不同：book-to-skill 解决「读」，video-shotcraft 解决「做视频」。技术底座是 Remotion--一个用 React/TypeScript 写视频的开源框架，所以产出是可编程、可复现的 TSX，不是黑盒生成。
核心能力四件套：真实页面捕获（real page captures）、2.5D 摄像机运动、节拍同步剪辑（beat-synced cuts）、电影级音效（film-grade SFX）。
包含什么
仓库里装的不只是一个模板，而是一整套视频生产资料：
| 内容 | 说明 |
|---|---|
| 104 张分镜配方卡 | 每张含用途、能量、建议时长、参数、实现笔记、已知坑 |
| 161 个运镜预览 | 覆盖 161 种风格，在线 Gallery 可搜索过滤 |
| Remotion 实现 | 调过参的 TSX demo，含真实的 easing 和 timing 参数 |
| 完整视频模板 | 验证过的 36.2 秒、1920×1080、30fps、10 分镜产品 promo |
| 组件与素材 | 2.5D 页面摄像机、字幕、闪切、数字滚动、SFX、捕获脚本 |
| 生产方法论 | 捕获、视觉指导、分镜、音效设计、节拍同步、终检 |
分镜配方卡是核心资产：每张卡是一个可复用的镜头套路（比如 spotlight-hero-card、deck-deal-flyin、row-embed），带参数和实现笔记，agent 能直接调用组合。161 个运镜预览在在线 Gallery 里能搜能筛能切换变体，挑中哪张卡直接复制名字丢给 agent。
内置模板：Ink Press
不想从零拼分镜，仓库自带一个验证过的完整模板 Ink Press：36.2 秒、1920×1080、30fps、10 个分镜，paper-ink-amber 风格，2.5D 真实页面摄像机运动，带标题卡、转场和一整套电影级 SFX。用法一句话：
Use video-shotcraft to make a promo for my product with the Ink Press template.agent 把你的产品截图、文案、品牌替换进去，复现同样的质量。这是从零到成片最快最稳的路径。官方说更多模板在路上。
怎么装怎么用
最直接的方式：把仓库链接丢给你的 agent，说一句：
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraftagent 自己 clone 并 link 到技能目录。也可以用 skills CLI 或手动：
npx skills add Vincentwei1021/video-shotcraft
# 或手动
git clone https://github.com/Vincentwei1021/video-shotcraft.git
ln -s "$(pwd)/video-shotcraft" ~/.claude/skills/video-shotcraft # Claude Code
ln -s "$(pwd)/video-shotcraft" ~/.codex/skills/video-shotcraft # Codex装好后这样下指令：
Use video-shotcraft to create a promo for my desktop product.
Use the deck-deal-flyin and row-embed shot cards to present this feature.
Design a product close-up inspired by spotlight-hero-card.不指定分镜卡时，技能会先介绍内置模板问你要不要用；也可以先去 Gallery 挑好分镜再开工。国内开发者注意：作者在 AtomGit（atomgit.com/VincentWei/video-shotcraft）放了镜像，GitHub 拉不动可以走镜像。
三个 headless 渲染坑
要在无头 Linux 机器（CI）上渲染，有三个已知的墙：
- 并发上限：低核机器上
remotion still/render报「Maximum for --concurrency is 2」。解法：加--concurrency=1。 - 旧 Headless 被移除：新版 Chrome/Chromium 砍掉了 old headless 模式，让 Remotion 指向系统 chromium 会启动失败。解法：用 chrome-headless-shell 二进制，别用完整 Chrome。
- CDN 被墙：remotion.media 不可达时，自动下载 headless-shell 会被拒。解法：
--browser-executable=<本地 chrome-headless-shell 路径>。
三个 flag 配齐，内置模板的帧渲染就能跑通。
看法
video-shotcraft 命中的是「产品宣传视频」这个高频但门槛不低的需求。它的思路不是去和 Sora 这种生成式视频模型硬拼，而是把专业视频生产的「分镜套路 + 运镜参数 + 音效节拍」沉淀成一套可复用的 agent 技能资产，让 agent 用 Remotion 这种可编程框架组装。产物是 TSX 源码，可读、可改、可复现，这是它和黑盒生成最大的不同。
它适合两类人：一是独立开发者/小团队，产品做完了需要一条拿得出手的 promo 但请不起视频制作；二是想用 AI agent 做规模化视频生产、需要一套可复用分镜体系的人。门槛是你得用 Claude Code 或 Codex 这类支持 Agent Skills 的 host，且本地装得了 Remotion（需要 Node 和 Chrome 环境）。风险点是 Remotion 渲染吃资源、headless 环境坑多，CI 部署要做好三个 flag 的准备。
在 agent skill 从「读文档」往「做创作」延伸的趋势里，video-shotcraft 是一个把专业视频生产方法论沉淀成开源 skill 的样板。3492 星、Trendshift 上榜、今天还在 push，说明开发者确实在用它。
参考来源
- video-shotcraft GitHub 仓库：https://github.com/Vincentwei1021/video-shotcraft
- 在线 Gallery（161 运镜预览）：https://vincentwei1021.github.io/video-shotcraft/
- Remotion（视频渲染框架）：https://www.remotion.dev/
- AtomGit 镜像（国内）：https://atomgit.com/VincentWei/video-shotcraft
- 星数/fork/语言/许可证等数据依据 GitHub API（2026-08-04 核实，3492 stars）