datit309/supergraph / plugins/supergraph/skills/video-shotcraft
video-shotcraft
UnverifiedCreate cinematic product videos from shot recipe cards, a validated template, and code/audio assets (Remotion + real page screenshots + 2.5D camera moves + beat-synced cuts + sound design). Use when the user asks to turn a frontend project or webpage into a product video, says "use video-shotcraft to make a video/promo", names the Ink Press template or asks to reproduce its effect, or wants a single shot card's motion. 用镜头配方卡 + 已验收模板 + 代码/音频资产制作电影感产品视频(Remotion + 真实页面截图 + 2.5D 运镜 + 节奏卡点 + 声音设计)。当用户要求"用 video-shotcraft 做视频/宣传片"、把前端项目/网页做成产品视频、点名 Ink Press 模板或要求复刻模板片效果,或要用镜头卡做单个动效镜头时使用。
README_CN.md
View on GitHub<div align="center">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="./assets/brand/logo-mark-reverse.svg">
<source media="(prefers-color-scheme: light)" srcset="./assets/brand/logo-mark.svg">
<img alt="video-shotcraft logo" src="./assets/brand/logo-mark.svg" width="96" height="96">
</picture>
# video-shotcraft
[English](README.md) | **中文** | [日本語](README_JA.md) | [Русский](README_RU.md)
[](https://vincentwei1021.github.io/video-shotcraft/)
[](https://vincentwei1021.github.io/video-shotcraft/showcase.html)
[](https://github.com/Vincentwei1021/video-shotcraft/stargazers)
[](LICENSE)
[](SKILL.md)
[](SKILL.md)
[](https://atomgit.com/VincentWei/video-shotcraft)
<a href="https://trendshift.io/repositories/88911?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-88911" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/88911" alt="Vincentwei1021%2Fvideo-shotcraft | Trendshift" width="250" height="55"/></a>
<img src="./assets/readme/cover.webp" width="100%" alt="六个 Gallery 镜头,从左到右、从上到下:graze-face-tour、logo-shrink-wordmark-lockup、panel-grid-moves、product-card-progressive-assemble、space-camera-moves · exploded-view、spotlight-hero-card">
[**▶ 在 Gallery 浏览全部 150 个镜头**](https://vincentwei1021.github.io/video-shotcraft/) · [**🎬 看 Showcase 成片**](https://vincentwei1021.github.io/video-shotcraft/showcase.html)
</div>
## 它做什么
对 Claude Code 或 Codex 说一句「给我的产品做一支宣传片」。agent 会抓取你的真实页面,从调校好的动效配方库里挑镜头,
排分镜,用 [Remotion](https://www.remotion.dev/) 做动画,按音乐卡点剪辑,配上音效,逐帧检查,最后交给你一支
可以继续修改的 MP4。
它不是视频生成模型。每一帧都由代码基于你自己的截图和文案绘制,画面清晰、品牌准确,也能逐项修改。
**流程**

## 最近更新
> [!IMPORTANT]
> ### 🎬 2026-10 · 镜头库更新
> 全库 216 个镜头经打磨与评审,择优保留 **124 张卡 / 150 个镜头**。
> Gallery 样片已重新渲染,并统一采用 video-shotcraft 品牌素材。
- **2026-09 · [动效工作台](#动效工作台)**:成片交付后,在剪映式的浏览器编辑器里继续改。
- **2026-08 · 系列新成员 [video-talkcraft](https://github.com/Vincentwei1021/video-talkcraft)**:口播视频版,
给它口播稿和成品配音,所有动效节拍都钉在人声上([78 条口播动效样片](https://vincentwei1021.github.io/video-talkcraft/))。
- **2026-08 · 剪映工程导出**:成片可导出为可编辑的剪映草稿——底片按镜头切段、字幕重建为原生文本轨、
SFX/BGM 独立音轨。Mac 剪映 11.2 实测验收([方法](references/jianying-export.md))。
## ❤️ Sponsors
<table>
<tr>
<td align="center" valign="middle" width="25%">
<a href="https://go.apimart.ai/tw-video-shotcraft"><img src="./assets/readme/sponsors/apimart.png" width="200" alt="APIMart 标志"></a><br>
<a href="https://go.apimart.ai/tw-video-shotcraft"><b>APIMart</b></a>
</td>
<td>
<p>感谢 APIMart 赞助了本项目!APIMart 是专注 AI 图片/视频生成的低价 API 平台,GPT-Image-2 低至 $0.006/张,1 美元可出图 160+ 张。图片、视频一套异步 API 通吃,提交任务拿 ID、回调取结果,跑批万张不超时、换模型不改代码。按量付费、无月费,通过此<a href="https://go.apimart.ai/tw-video-shotcraft">注册链接</a>注册即可开用。</p>
</td>
</tr>
<tr>
<td align="center" valign="middle" width="25%">
<a href="https://www.packyapi.ai/register?aff=l9IZ"><img src="./assets/readme/sponsors/packycode.png" width="200" alt="PackyCode 标志"></a><br>
<a href="https://www.packyapi.ai/register?aff=l9IZ"><b>PackyCode</b></a>
</td>
<td>
<p>PackyCode 是一家稳定、高效的 API 中转服务商,通过统一域名、统一密钥接入主流大模型,支持智能容灾切换,并提供专属 Codex / Claude Code 高速通道。</p>
<p>新用户可获 $1 免费体验额度,首充享折扣,多分组折扣低至 2 折起。支持人民币 1:1 充值,无汇率加价及额外充值手续费。</p>
<p><a href="https://www.packyapi.ai/register?aff=l9IZ">注册并开始使用 PackyCode →</a></p>
</td>
</tr>
<tr>
<td align="center" valign="middle" width="25%">
<a href="https://aws.amazon.com/"><img src="./assets/readme/sponsors/aws.svg" width="200" alt="AWS 标志"></a><br>
<a href="https://aws.amazon.com/"><b>AWS</b></a>
</td>
<td>
<p>Amazon Web Services(AWS)提供稳定、可扩展的云计算服务,涵盖计算、存储和 AI。</p>
<p><a href="https://aws.amazon.com/">了解 AWS →</a></p>
</td>
</tr>
</table>
## 安装
为 Claude Code 和 Codex 调校。最简单的方式是把仓库链接丢给你的 agent:
```text
帮我安装这个 skill:https://github.com/Vincentwei1021/video-shotcraft
```
或者用 [skills](https://skills.sh/) 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](https://vincentwei1021.github.io/video-shotcraft/)
里搜索、筛选、复制卡名。
<table>
<tr>
<td align="center" width="50%"><b>开场与品牌</b> · 11 个<br><img src="./assets/readme/examples/opening.webp" width="100%" alt="text-as-mask:透过巨型标题字看到产品界面"><br><sub>text-as-mask:产品从标题字里透出来</sub></td>
<td align="center" width="50%"><b>运镜与空间</b> · 13 个<br><img src="./assets/readme/examples/camera.webp" width="100%" alt="exploded-view:页面 3D 倾斜后构件炸开"><br><sub>exploded-view:页面倾斜、构件拆开</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>转场</b> · 19 个<br><img src="./assets/readme/examples/transition.webp" width="100%" alt="card-flock-tumble:一群卡片翻滚成大标题"><br><sub>card-flock-tumble:卡片群翻滚成标题</sub></td>
<td align="center" width="50%"><b>文字与字卡</b> · 25 个<br><img src="./assets/readme/examples/typography.webp" width="100%" alt="flying-words:功能词穿过文字隧道"><br><sub>flying-words:文字隧道收成品牌短句</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>界面登场</b> · 22 个<br><img src="./assets/readme/examples/ui-entrance.webp" width="100%" alt="card-stack:一叠配方卡扇形发牌"><br><sub>card-stack:一叠卡片扇形发牌落位</sub></td>
<td align="center" width="50%"><b>交互演示</b> · 13 个<br><img src="./assets/readme/examples/interaction.webp" width="100%" alt="palette-theme-ripple:换主题时颜色波纹扫过界面"><br><sub>palette-theme-ripple:新主题像波纹扫过界面</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>数据与指标</b> · 9 个<br><img src="./assets/readme/examples/data.webp" width="100%" alt="axis-rescale-shock:数据冲高,坐标轴重新缩放"><br><sub>axis-rescale-shock:数据冲破坐标轴</sub></td>
<td align="center" width="50%"><b>光效与强调</b> · 23 个<br><img src="./assets/readme/examples/effects.webp" width="100%" alt="spotlight-sweep:聚光灯扫出标题"><br><sub>spotlight-sweep:舞台追光找到标题</sub></td>
</tr>
<tr>
<td align="center" width="50%"><b>节奏与蒙太奇</b> · 8 个<br><img src="./assets/readme/examples/rhythm.webp" width="100%" alt="paparazzi-flash:三次闪光切换不同裁切"><br><sub>paparazzi-flash:三次闪光、三种裁切、落在一个数字上</sub></td>
<td align="center" width="50%"><b>收尾</b> · 7 个<br><img src="./assets/readme/examples/outro.webp" width="100%" alt="input-morph-assemble:输入框变成 logo"><br><sub>input-morph-assemble:聊天输入框拼成标志</sub></td>
</tr>
</table>
每张卡在 `references/shots/<类别>/<卡名>.md`,对应的 Remotion 实现在 `demos/<类别>/<卡名>/`
(怎么接进你的工程见 [demos/README.md](demos/README.md))。
## 动效工作台
交付后 skill 会在浏览器里打开一个剪映式的编辑器(`node workbench/scripts/open.mjs <工程>`)。成片按原始镜头
拆成镜头 / 转场 / 字幕 / 音效多轨;选中任意镜头可以改文案、字号和颜色,镜头可挪、可裁、可变速,镜头库里的
150 个镜头都能直接拖上轨,改完用 Remotion 导出。预览与渲染逐帧一致。

[工作台图文指南:各区域与功能](workbench/GUIDE.md) · [成片接入契约](references/workbench.md)
## 你会拿到什么
| 产出 | 说明 |
|---|---|
| 成片 | `MP4`,1920×1080、30fps、h264,含音乐和音效 |
| Remotion 工程 | 整支片的源码:每个镜头都是一个 React 组件,你或 agent 都能改 |
| 动效工作台 | 交付后自动打开:多轨时间线、属性面板、变速、换镜头、导出([详情](#动效工作台)) |
| 剪映工程 | 可选:可编辑的剪映草稿,镜头分段、字幕和音轨都能改 |
| 社交平台发布 | 可选,用户要求时:通过 Upload-Post 把成片发到 TikTok / Instagram / YouTube / LinkedIn / X 等;先确认文案与平台、dry-run 后再发([说明](references/publish-upload-post.md)) |
另外还附带:可复用的 Remotion 组件(2.5D 页面相机、字幕、闪切、数字滚动)、149 个音效和 5 首 BGM、
页面素材采集脚本,以及整套制作方法(素材采集、风格定调、分镜、声音设计、节奏卡点、最终验收),
见 [references/](references/pipeline.md)。
## 作品展示
**投稿你的作品**:用 video-shotcraft 做了片子?用 Showcase 投稿表单
[提交](https://github.com/Vincentwei1021/video-shotcraft/issues/new?template=showcase.yml),审核通过后会出现在
[Showcase 页面](https://vincentwei1021.github.io/video-shotcraft/showcase.html)。
## 环境要求
| 需要 | 用途 |
|---|---|
| Node.js 和 npm | Remotion 渲染、成片模板和动效工作台 |
| ffmpeg / ffprobe | 抽帧检查与最终验收 |
| [uv](https://docs.astral.sh/uv/) | 只在分析 BGM 节拍时用(跑一次性的 Python 脚本) |
| puppeteer | 只在抓取页面时用,采集脚本会按需安装 |
Remotion 首次渲染时会自动下载自己的无头 Chrome。已在 macOS 上测试,Linux 参考下面的说明。
<details>
<summary><b>Linux 服务器 / CI 注意事项</b></summary>
在无显示器的 Linux 服务器上渲染(实测环境:2 核、Node 22)会遇到三个坑,各加一个参数就能解决:
1. **并发上限**:低核机器上 `remotion still/render` 会报 "Maximum for --concurrency is 2"。加 `--concurrency=1`。
2. **旧版 headless 被移除**:新版 Chrome/Chromium 删了旧 headless 模式,让 Remotion 指向系统 chromium 会启动失败。
改用 chrome-headless-shell 二进制,不要用完整版 Chrome。
3. **CDN 访问不了**:remotion.media 访问不了时(国内常见),headless-shell 自动下载会失败。
用 `--browser-executable=<本地 chrome-headless-shell 路径>` 指定本地二进制。
加上这三个参数后,内置模板即可正常渲染。
</details>
<details>
<summary><b>项目结构</b></summary>
```text
video-shotcraft/
├── SKILL.md # Agent 使用入口与核心制作规则
├── references/
│ ├── pipeline.md # 完整制作流水线
│ ├── shots/ # 124 张镜头配方卡,按功能分 10 类
│ ├── sequences/ # 可复用的全片结构与桥段模板
│ ├── aesthetic-rules.md # 视觉验收准则
│ ├── music-beat-sync.md # BGM 节奏分析与卡点方法
│ ├── sound-design.md # 声音设计方法与判例
│ ├── jianying-export.md # 剪映工程导出方法
│ ├── publish-upload-post.md # 社交平台发布(可选,Upload-Post API)
│ └── workbench.md # 动效工作台:成片接入契约 + 可编辑性规则
├── demos/ # 镜头卡的 Remotion 参考实现(同类别目录)
├── gallery/ # 在线样片画廊的静态站点
├── template/ # 可直接运行的完整成片模板
├── jianying-export/ # 剪映草稿安装模块(Mac 实测 / Windows 未验证)
├── publish/ # 社交平台发布脚本(纯标准库 Python)+ 离线单测
├── workbench/ # 交付后的动效工作台(Vite + Remotion Player)
└── assets/
├── lib/ # 可复制使用的 Remotion 组件
├── scripts/ # 页面素材采集脚本
└── audio/ # 音频资产
├── bgm/ # 5 首 BGM 备选
└── sfx/<类别>/ # 149 个音效,按场景分 16 类
```
完整工作流和实现要求见 [SKILL.md](SKILL.md)、[制作流水线](references/pipeline.md) 与
[视觉验收准则](references/aesthetic-rules.md)。
</details>
## 音频与素材
音效按场景 / 材质分 16 类(`transition` `impact` `riser` `camera` `ui` `text` `paper` `film` `light` `data`
`scifi` `mech` `glass` `fluid` `crowd` `counter`),找音先定类别再挑音色。类别索引与逐文件用途见
[sound-design.md](references/sound-design.md),来源与许可见 [ATTRIBUTION.md](assets/audio/ATTRIBUTION.md)。
模板内的产品截图为演示素材。对外发布成片前,请替换为你自己产品的截图,并确认其中的数据、客户信息和个人信息
是否需要脱敏。
## 许可
- 代码与文档:[Apache-2.0](LICENSE)。
- `assets/audio/` 下的音频:各自按其授权使用,见 [ATTRIBUTION.md](assets/audio/ATTRIBUTION.md)。
- [Remotion](https://www.remotion.dev/) 有自己的[许可协议](https://github.com/remotion-dev/remotion/blob/main/LICENSE.md):
个人与小团队免费,公司可能需要付费许可。
## 致谢
本库中许多镜头配方源自对优秀官方产品宣传片动效语言的研究学习,包括 **ClickUp、Perplexity、Slack、Notion、
Figma、Framer、Bear、Raycast、Pitch、Miro、Superhuman、Loom** 等产品的宣传片。镜头卡记录的是从零重新实现的
动效技法(时序、缓动、编排),仓库中不包含上述影片的任何素材、画面或品牌资产。所有商标归各自所有者所有,
上述公司与本项目无关联,亦未对本项目背书。
也感谢 **[Remotion](https://www.remotion.dev/)**——驱动本库全部 demo 与模板的 React 视频框架;
**[Mixkit](https://mixkit.co/)**——库内音效与音乐素材的来源(免费授权);游戏手感与动画社区的公开方法论,
多张镜头卡受其启发;以及 **Claude Code**——本库自身的构建、迭代与验收都由它完成,用的正是这个 skill 教的工作流。
## 关注我
<p>
<a href="https://x.com/VincentWei93"><img alt="在 X 关注 Vincent" src="https://img.shields.io/badge/X-Follow_Me-000000?style=for-the-badge&logo=x&logoColor=white"></a>
<a href="https://www.douyin.com/user/MS4wLjABAAAAK1pkjBxilk2Oi_9h_vFyD-lTAu9CTlvhmOtkosDvvxg"><img alt="在抖音关注 Vincent" src="https://img.shields.io/badge/Douyin-Follow_Me-000000?style=for-the-badge&logo=tiktok&logoColor=white"></a>
<a href="https://xhslink.cn/m/At9iP2d5C1V"><img alt="在小红书关注 Vincent" src="https://img.shields.io/badge/Red_Note-Follow_Me-FF2442?style=for-the-badge&logo=xiaohongshu&logoColor=white"></a>
</p>
## Star 历史
<a href="https://www.star-history.com/?repos=Vincentwei1021%2Fvideo-shotcraft&type=date&legend=top-left">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&theme=dark&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
<source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
<img alt="Star History Chart" src="https://api.star-history.com/chart?repos=Vincentwei1021/video-shotcraft&type=date&legend=top-left&sealed_token=DQ8_yn0k8in6tP80CRd9Ghuk1fcdEW7poFh9ticGB3wMNO-E_i6g51sUiQWCAQYP0u0bjRweuIfGoRS8FnrIz86oFp1lcl5zu2vrEJrQOoNvwdUSwmm8XNPkAiln1o-EBAX0uU8k6ReIlSRufGLqpoxsWshMSZ9mmok6ox5XXIUO77b7zOgp2yRIH6yR" />
</picture>
</a>
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |