# Video Shotcraft

Creates cinematic product videos from real page captures with Remotion and sound design.

- Repository: https://github.com/Vincentwei1021/video-shotcraft (15798 stars)
- Category: Media
- License: Apache-2.0
- Last updated: 2026-10-29
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add Vincentwei1021/video-shotcraft --skill video-shotcraft -g -a claude-code -y`
Codex: `npx skills add Vincentwei1021/video-shotcraft --skill video-shotcraft -g -a codex -y`
Cursor: `npx skills add Vincentwei1021/video-shotcraft --skill video-shotcraft -g -a cursor -y`
Gemini CLI: `npx skills add Vincentwei1021/video-shotcraft --skill video-shotcraft -g -a gemini-cli -y`

## Description

Create cinematic product videos from frontend projects or webpages with Remotion, real page captures, shot cards, the Ink Press template, beat sync and sound design. Use for full product promos, reproducing Ink Press, single shot-card effects, or finding, adding, replacing and aligning sound effects in an existing product video or shot, including candidate-only SFX searches. 用真实页面、镜头卡与 Ink Press 模板制作产品宣传片；用户要求用 video-shotcraft 做视频、复刻模板、制作单镜头，或给已完成的产品片/镜头找音效候选、加音效、换音效、对齐声音时使用。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# video-shotcraft：电影感产品视频制作

一个自包含的制作能力库：124 张镜头配方卡（附 demo 实现源码与动态样片
画廊）、一支已验收的完整宣传片模板、可复用组件、Freesound 音效选材工具与 BGM 备选、六阶段工作流。
当前 focus 是 web/桌面产品宣传片，但镜头卡本身是通用动效词汇, , 也可以单独抽卡做任意视频里的单个镜头。

## 调用时先判断任务范围

**仅处理已有视频或镜头的音效**：直接读 `references/sound-design.md` 与
`references/sfx-sourcing.md`，进入声音选材、分析或对齐步骤，无需重新选择整片创作模式。
只要候选时执行 `sfx-source.py search` 并给出素材页/试听入口，不下载、不改画面、不渲染；
动作、材质、目标时长和许可要求已足够搜索时，不要求用户先提供完整视频工程。
用户已指定音频时沿用该文件，需要测量则执行 `analyze`，不自动搜索替代声音。
单纯调整 BGM 走 sound-design 的 BGM 流程；静音或明确不要音效时不触发 SFX 搜索。

**新制作完整宣传片**时，再按以下模式继续。

完整宣传片有三种互不合并的模式。在开始素材采集、分镜或实现前，先判断用户
是否已经明确选择；已经选择时直接执行，不重复询问，也不要改成另一种模式。

1. **直接使用模板**：保持 Ink Press 原有替换流程。读 `template/TEMPLATE.md`，
   按既有镜头结构替换目标产品的截图、文案和品牌信息。
2. **自主自由创作**：读 `references/pipeline.md`。Agent 根据用户已有要求和项目
   内容，自主决定视觉方向、镜头映射、分镜、素材和音频，连续推进到成片；不在
   产品简报、styleframe、镜头映射或分镜阶段暂停等待用户确认。
3. **共同创作**：读 `references/guided-free-creation.md`。Agent 先提出有依据的
   判断和方案，由用户依次确认产品简报、需求决策、视觉方向、镜头映射和最终
   分镜；分镜放行后再进入 `references/pipeline.md` 的最终素材采集与制作阶段。

用户提供了项目路径、网址、录屏或页面截图但尚未选模式时，先做一次**最小、
只读的产品检查**：了解产品定位、主要功能、页面视觉、可展示状态和素材风险；
不修改业务项目、不采集敏感数据、不写视频代码。检查后给出三种模式，并说明：

- Ink Press 是否适合该产品、适合与不适合的具体依据；
- 自主自由创作与共同创作各自是否适合、预计会保留哪些产品视觉线索；
- Agent 推荐哪一种模式及其依据和取舍。

然后明确询问：**“根据上面的产品检查，我推荐使用 ×× 模式。要按这个模式继续吗？”**
同时告知用户：可前往 https://vincentwei1021.github.io/video-shotcraft/
浏览动态样片，并挑选希望在视频中使用的动效镜头。

用户尚未提供可检查的项目或页面时，简要介绍三种模式再询问；不要仅因 Ink Press
是现成模板就默认推荐它。

- 用户选择模板：完整阅读 `template/TEMPLATE.md`，按原模板流程执行。
- 用户选择自主自由创作：完整阅读 `references/pipeline.md`，Agent 自主推进，不逐阶段等待确认。
- 用户选择共同创作：完整阅读 `references/guided-free-creation.md`，按其中的确认节点协作。
- 用户尚未决定：停在此处等待选择；不要默认替用户选择，也不要开始制作。

**例外一：用户已点名 Ink Press 模板时，视为模板模式已选定。**
例如“用 Ink Press 模板给我的产品做宣传片”。此时不要再询问，直接完整阅读
`template/TEMPLATE.md` 按模板路线执行。

**例外二：用户已明确指定要使用或参考某些镜头卡时，镜头约束已经选定。**
例如“用 `deck-deal-flyin` 和 `row-embed` 做这支视频”或“参考
`spotlight-hero-card` 的效果”。此时不要介绍模板、也不要询问是否使用模板；
按 Gallery 名称解析规则确认指定镜头，完整阅读每张卡，并按卡片的“参考实现”
定位准确 demo 源码。单镜头可在目标素材明确后执行；完整宣传片若尚未说明采用
自主自由创作还是共同创作，只询问这两种模式，指定镜头作为后续制作约束，不自动
等同于共同创作。

## 四种用法

The rest: https://github.com/Vincentwei1021/video-shotcraft/blob/HEAD//SKILL.md