AI video skill for Claude Code & Codex — cinematic, editable product promos with Remotion: 124 shot recipe cards, 150 motion previews, beat sync, sound design, Motion Workbench & JianYing (CapCut CN) export.

★ 19,973⑂ 1,871👁 38⑃ 80● 62▤ 2
TypeScriptApache-2.0Created 2026-07-19vincentwei1021.github.io/video-shotcraft/
下载:Showcase media assetsshowcase-media ↓showcase-media2026-09-01
+467
日增长
19,973
stars
1,871
forks
38
watchers
80
prs
62
issues
2
releases

README

video-shotcraft



English | 中文 | 繁體中文 | 日本語 | Русский














▶ 在 Gallery 浏览全部 150 个镜头 · 🎬 看 Showcase 成片



 它做什么

对 Claude Code 或 Codex 说一句「给我的产品做一支宣传片」。agent 会抓取你的真实页面,从调校好的动效配方库里挑镜头,
排分镜,用 Remotion 做动画,按音乐卡点剪辑,配上音效,逐帧检查,最后交给你一支
可以继续修改的 MP4。

它不是视频生成模型。每一帧都由代码基于你自己的截图和文案绘制,画面清晰、品牌准确,也能逐项修改。

流程

!8 秒循环流程动图:你的产品 → 抓取真实页面 → 镜头配方卡排分镜 → Remotion 动画 → 踩点剪辑与声音设计 → 渲染与逐帧验收 → MP4、动效工作台与剪映工程

 最近更新

 [!IMPORTANT]
  🎬 2026-10 · 镜头库更新
 全库 216 个镜头经打磨与评审,择优保留 124 张卡 / 150 个镜头。
 Gallery 样片已重新渲染,并统一采用 video-shotcraft 品牌素材。

- 2026-09 · 动效工作台:成片交付后,在剪映式的浏览器编辑器里继续改。
- 2026-08 · 系列新成员 video-talkcraft:口播视频版,
  给它口播稿和成品配音,所有动效节拍都钉在人声上(78 条口播动效样片)。
- 2026-08 · 剪映工程导出:成片可导出为可编辑的剪映草稿——底片按镜头切段、字幕重建为原生文本轨、
  SFX/BGM 独立音轨。Mac 剪映 11.2 实测验收(方法)。

 ❤️ Sponsors




  
  APIMart


  感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此注册链接注册即可开用。




  
  AWS


  Amazon Web Services(AWS)提供稳定、可扩展的云计算服务,涵盖计算、存储和 AI。
  了解 AWS →




 安装

为 Claude Code 和 Codex 调校。最简单的方式是把仓库链接丢给你的 agent:

text
帮我安装这个 skill:https://github.com/Vincentwei1021/video-shotcraft


或者用 skills CLI:

bash
npx skills add Vincentwei1021/video-shotcraft


或者手动安装:

bash
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


国内访问 GitHub 慢的话,可以从 AtomGit 镜像克隆:
git clone https://atomgit.com/VincentWei/video-shotcraft.git。

 使用

直接描述你想要的片子就行,不需要命令。

| 你说 | 会发生什么 |
|---|---|
| 用 video-shotcraft 给我的产品做一支宣传片。 | agent 先介绍 Ink Press 模板并问你是否采用,然后抓取页面、做片 |
| 用 Ink Press 模板给这个仓库做一支发布片。 | 最快的路径:把你的截图、文案和标志放进已验收的模板 |
| 用 deck-deal-flyin 和 row-embed 两张镜头卡展示这个功能。 | 你按名字点镜头(名字可以直接从 Gallery 复制) |
| 参考 spotlight-hero-card,为这个页面设计一个产品特写镜头。 | 单个镜头,按你的产品改编 |

 镜头库

124 张配方卡,分 10 类,共 150 个镜头。可以在 Gallery
里搜索、筛选、复制卡名。



开场与品牌 · 11 个text-as-mask:产品从标题字里透出来
运镜与空间 · 13 个exploded-view:页面倾斜、构件拆开


转场 · 19 个card-flock-tumble:卡片群翻滚成标题
文字与字卡 · 25 个flying-words:文字隧道收成品牌短句


界面登场 · 22 个card-stack:一叠卡片扇形发牌落位
交互演示 · 13 个palette-theme-ripple:新主题像波纹扫过界面


数据与指标 · 9 个axis-rescale-shock:数据冲破坐标轴
光效与强调 · 23 个spotlight-sweep:舞台追光找到标题


节奏与蒙太奇 · 8 个paparazzi-flash:三次闪光、三种裁切、落在一个数字上
收尾 · 7 个input-morph-assemble:聊天输入框拼成标志



每张卡在 references/shots//.md,对应的 Remotion 实现在 demos///
(怎么接进你的工程见 demos/README.md)。

 动效工作台

交付后 skill 会在浏览器里打开一个剪映式的编辑器(node workbench/scripts/open.mjs )。成片按原始镜头
拆成镜头 / 转场 / 字幕 / 音效多轨;选中任意镜头可以改文案、字号和颜色,镜头可挪、可裁、可变速,镜头库里的
150 个镜头都能直接拖上轨,改完用 Remotion 导出。预览与渲染逐帧一致。

!动效工作台

工作台图文指南:各区域与功能 · 成片接入契约

 你会拿到什么

| 产出 | 说明 |
|---|---|
| 成片 | MP4,1920×1080、30fps、h264,含音乐和音效 |
| Remotion 工程 | 整支片的源码:每个镜头都是一个 React 组件,你或 agent 都能改 |
| 动效工作台 | 交付后自动打开:多轨时间线、属性面板、变速、换镜头、导出(详情) |
| 剪映工程 | 可选:可编辑的剪映草稿,镜头分段、字幕和音轨都能改 |
| 社交平台发布 | 可选,用户要求时:通过 Upload-Post 把成片发到 TikTok / Instagram / YouTube / LinkedIn / X 等;先确认文案与平台、dry-run 后再发(说明) |

另外还附带:可复用的 Remotion 组件(2.5D 页面相机、字幕、闪切、数字滚动)、Freesound 音效搜索下载工具和 5 首 BGM、
页面

Top issues

Latest release

Showcase media assets showcase-media 2026-09-01
User-submitted showcase videos + showcase.json (published by showcase-publish.yml / maintainer uploads, not tracked in git).

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON