AI video skill for Claude Code & Codex — cinematic product videos with Remotion: 106 shot recipe cards, 161 motion previews, a production-ready template
# Add to your Claude Code skills
git clone https://github.com/Vincentwei1021/video-shotcraftGuides for using ai agents skills like video-shotcraft.
video-shotcraft is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Vincentwei1021. AI video skill for Claude Code & Codex — cinematic product videos with Remotion: 106 shot recipe cards, 161 motion previews, a production-ready template. It has 111 GitHub stars.
video-shotcraft's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/Vincentwei1021/video-shotcraft" and add it to your Claude Code skills directory (see the Installation section above). video-shotcraft ships a SKILL.md manifest, so compatible agents can discover and load it automatically.
video-shotcraft is primarily written in TypeScript. It is open-source under Vincentwei1021 on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh video-shotcraft against similar tools.
No comments yet. Be the first to share your thoughts!
Unlocks once the catalog security scan passes (runs nightly).
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
一个自包含的制作能力库:106 张镜头配方卡(附 demo 实现源码与动态样片 画廊)、一支已验收的完整宣传片模板、可复用组件与音频资产、六阶段工作流。 当前 focus 是 web/桌面产品宣传片,但镜头卡本身是通用动效词汇—— 也可以单独抽卡做任意视频里的单个镜头。
每次调用此 skill,在开始任何素材采集、分镜或实现前,先向用户说明:
template/ 中一支已验收的 36.2 秒产品宣传片模板
Ink Press(墨压):1920×1080、30fps、纸墨琥珀风格,含 10 个完整镜头、
2.5D 真实页面运镜、字卡、转场和已配好的电影感 SFX;替换目标产品的截图、
文案和品牌信息即可适配。然后明确询问:“要使用这支现成模板来制作这支视频吗?” 同时告知用户:可前往 https://vincentwei1021.github.io/video-shotcraft/ 浏览动态样片,并挑选希望在视频中使用的动效镜头。
template/TEMPLATE.md,再按模板路线执行。references/pipeline.md 的阶段 0 继续,走自由创作或单镜头路线。例外一:用户已点名 Ink Press 模板时,视为模板路线已选定。
例如"用 Ink Press 模板给我的产品做宣传片"。此时不要再询问,
直接完整阅读 template/TEMPLATE.md 按模板路线执行。
例外二:用户已明确指定要使用或参考某些镜头卡时,视为路线已经选定。
例如“用 deck-deal-flyin 和 row-embed 做这支视频”或“参考
spotlight-hero-card 的效果”。此时不要介绍模板、也不要询问是否使用模板;
直接确认指定的镜头卡,完整阅读每张卡及其 demos/<卡名>/ 实现源码后执行。
template/TEMPLATE.md,按"换产品复现指南"替换素材逐镜头适配。
最快且质量有底。references/pipeline.md
六阶段走(阶段 0 开工三问起步)。references/shots/ 选卡(或让用户在
gallery/ 画廊里挑),读卡全文 + demos/<卡名>/ 实现源码,
适配到目标素材。复刻既有页面必须用真实截图;手搓 UI 限非复刻场景,且质量与表达 明确性是硬门槛。 表现产品真实页面时第一步就起本地 dev server, 用无头浏览器截全页 2x 纹理 + 元素级抠图 + layout.json 坐标表。 非复刻场景(抽象开场/品牌段/独立展示组件)允许手搓 UI,但达不到 出版级质感或观众看不懂它表达什么,就回截图路线。页面数据默认 可用现成数据;是否脱敏在素材确认时问用户。
整支视频的视觉语言必须从产品自身生长,不能另造一套不相干的 “宣传片皮肤”。 做 styleframe 前,先从产品/网站的设计系统、源码或 computed styles 中提取并写入设计 spec:字体家族与字重、字号层级、 行高/字距,栅格、间距、对齐、信息密度与圆角,以及背景/表面/正文/ 强调/状态色、渐变和材质。片中所有标题、字幕、数字、字卡、版式、 转场、粒子、光效和其他动效配色都必须复用或克制扩展这套 tokens, 同时匹配产品的调性、品味和质感。走模板或镜头卡路线时,只继承其 镜头结构、运动语法、节奏和已调参数;字体、排版、配色与材质必须按 目标产品重新蒙皮。若因叙事需要偏离产品视觉,先说明理由并让用户确认。
电影感来自运镜、光影、节奏与声音的配合,不来自炫技动画。 被反复认可的是:单主角完整动作弧(聚光→推近→悬浮→归位)、 物理隐喻驱动的加速度(发牌)、侧斜机位 orbit 环绕特写、 riser→impact→sparkle 的声音句式。批量元素入场靠运动本身, 不靠逐个发光——装饰性 glint/泛光群发即廉价,单点高质量光效可做。
每个镜头只讲一个动效;关键信息落定后必须呼吸。 一种动画手法(飞入/堆叠/翻页)全片只当一次主角,重复镜头、重复 tagline 一律删。节奏偏好是单向的:历史反馈全部指向"放慢/停留", 从未有一次"太慢了"——品牌字标落定 hold ≥1s、批量动效收尾留 0.5s 静止、开场主体动作给足 3s。排时间线时预先给 hold/rest 留帧预算。
强节奏 BGM 的片子,所有转场和动效必须卡在拍上。
用户已选好音乐 → 开工前先做节奏分析(librosa 网格拟合求真实
BPM/相位 + 带通找鼓点重音),时间线用拍号 beatF(n) 写,渲后从
成片抽音轨回测切点误差 ≤3f。方法论见 references/music-beat-sync.md。
用镜头卡动效必须先读它的 demo 实现代码。 配方卡给的是语义和
参数表,demos/<卡名>/ 里的源码才是调校过的参数真相(缓动、时值
配比、摘罩时机、已知坑的规避写法)。允许适配性改动,但卡上
"已知坑/命门"标注的参数不得降档——质量标准只升不降。凭卡名和
理解新写=放弃全部调校积累。
廉价确认物前置:素材→styleframe→分镜逐级确认,方向问题不进 逐镜头阶段。 一个纯 HTML/CSS 对比页 + 一张截图就能锁定全片 色板/字体/光感;分镜表与设计 spec 同文档一次确认。确认物越廉价、 越早,返工越便宜。
验收贯穿全程 + 交付前独立审查。 阶段 4 起每个镜头用
npx remotion still 出静帧自检、每轮修改后整片渲染 + ffmpeg
抽帧回看;交付前必须派一个干净上下文的 subagent 做独立视觉审查
(只给成片/关键帧/审美准则/分镜表,逐条出带帧号证据的报告)——
制作者对自己的产出有确认偏差,首检永远不能交给用户。
确定性渲染:禁 Date.now()/Math.random(),一切伪随机固定
种子(mulberry32/哈希,seed 从 index 派生),逐帧可复现。
按 references/pipeline.md 六阶段执行(阶段 0 开工三问:音乐选好了吗 /
用模板还是自由创作 / 数据合规口径)。阶段 3(分镜)时扫
references/shots/ 各卡 frontmatter 按能量曲线选镜头;阶段 4–6 持续
对照 references/aesthetic-rules.md 自检;阶段 5 读
references/sound-design.md;卡点片全程贴 references/music-beat-sync.md。
| 时机 | 读 |
|---|---|
| 项目启动 | pipeline.md(阶段 0 三问) |
| 用户已选 BGM | music-beat-sync.md(先分析再分镜) |
| 走模板路线 | template/TEMPLATE.md 全文 |
| 分镜设计 | sequences/ 桥段模板(全片骨架先填空);shots/ 全部 frontmatter;选中的卡读全文 |
| 逐镜头实现 | 该镜头卡全文 + demos/<卡名>/ 实现源码全文 + assets/lib/ 对应组件 |
| 声音设计 | sound-design.md + assets/audio/ |
| 验收 | aesthetic-rules.md 全文过 checklist(独立 subagent 执行) |
assets/lib/ 组件 copy 进新项目后自由修改(不 import 本库)。
清单:PageCam(2.5D 页面相机——一切"真实页面"镜头的地基)、DigitRoll、
FlashCut、Caption、FlatPanel、VerticalTicker(3D 无限滚动墙)、
helpers(rand/shake/camera/motion)。FlatPanel 与 helpers/camera 需要
three + @react-three/fiber + @remotion/three 依赖,其余仅需 remotion。assets/scripts/capture-template.mjs 复制后改顶部 CONFIG(BASE/路由/选择器)。assets/audio/ 音效直接复制使用(免费商用授权,见 audio/ATTRIBUTION.md);
assets/audio/bgm/ 是节奏感强的 BGM 备选。demos/ 各卡实现源码:多数为自包含灰阶 demo(部分 import
demos/_fixtures/Fixtures.tsx 的假 UI 场景件,个别 import
demos/_textures/ 的真实页面纹理),copy 进 Remotion 项目即可跑。template/ 完整可渲染工程:npm install && npx remotion render src/index.ts AiflPromo out/promo.mp4。gallery/ 静态画廊:cd gallery && python3 -m http.server 4178
后浏览器打开,106 卡 161 条动态样片可浏览/搜索/多选复制卡名——
适合让用户看着样片挑镜头。An agent skill for crafting cinematic product videos: 106 shot recipe cards · 162 styles · 161 motion previews · a production-ready template
video-shotcraft is an AI agent skill that turns Claude Code or Codex into a motion-design studio: point it at your product and it storyboards, animates, and sound-designs a cinematic promo, marketing, launch, or demo video with Remotion — real page captures, 2.5D camera moves, beat-synced cuts, and film-grade SFX included.
The 38-second Gallery intro below was itself produced with this skill — storyboard, shot implementation, and sound design were all done by an agent following the toolkit's methodology:
https://github.com/user-attachments/assets/cba2df8a-4b2e-4247-bace-d0b1dea9c2bd
Browse every shot card and motion preview online: Gallery — search, filter, switch between variants, and copy selected shot-card names.
The most direct way: hand the repo link to your agent. In Claude Code / Codex or a similar agent, just say:
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraft
The agent will clone the repo and link it into your skills directory. Or install with the skills CLI / manually:
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
# or
ln -s "$(pwd)" ~/.codex/skills/video-shotcraft # Codex
Then make requests like:
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.
If no shot card is specified, the skill introduces the built-in video template first and asks whether to use it; you can also pick shots in the Gallery before starting.
The skill ships with Ink Press — a validated, complete promo template: 36.2 seconds, 1920×1080, 30fps, 10 shots in a paper-ink-amber style, with 2.5D real-page camera moves, title cards, transitions, and a fully pinned cinematic SFX pass:
https://github.com/user-attachments/assets/4cf5af51-98f3-4af2-8ab2-7267f470513d
To use it, just tell your agent:
Use video-shotcraft to make a promo for my product with the Ink Press template.
The agent swaps in your product's screenshots, copy, and branding to reproduce the same quality — the fastest, most reliable path to a finished film.
More templates are on the way.
| Content | Description |
|---|---|
| 106 shot recipe cards | Purpose, energy, suggested duration, parameters, implementation notes, and known pitfalls |
| 161 motion previews | Covering 162 styles; searchable and filterable in the online Gallery |
| Remotion implementations | Tuned TSX demos containing the actual easing and timing parameters for each card |
| Complete video template | A validated 36.2-second, 1920×1080, 30fps product promo with 10 shots |
| Components and assets | 2.5D page camera, captions, flash cuts, digit rolls, SFX, and capture scripts |
| Production methodology | Capture, visual direction, storyboarding, sound design, beat sync, and final QA |
The toolkit primarily targets web and desktop product promos, while individual shot cards can also be used in feature demos, brand films, launch videos, and other motion projects.
video-shotcraft/
├── SKILL.md # Agent entry point and core production rules
├── references/
│ ├── pipeline.md # End-to-end production workflow
│ ├── shots/ # 106 shot recipe cards
│ ├── sequences/ # Reusable full-video structures and sequence patterns
│ ├── aesthetic-rules.md # Visual QA criteria
│ ├── music-beat-sync.md # BGM analysis and beat-sync methodology
│ └── sound-design.md # Sound-design guidance and examples
├── demos/ # Remotion reference implementations for shot cards
├── gallery/ # Static motion-preview Gallery
├── template/ # Runnable complete video template
└── assets/
├── lib/ # Reusable Remotion components
├── scripts/ # Page-asset capture scripts
└── audio/ # SFX and attribution details
For the complete workflow and implementation requirements, see SKILL.md, the production pipeline, and the visual QA criteria.
Audio files under assets/audio/ may be used according to their respective license terms.
See ATTRIBUTION.md for sources and license details.
Product screenshots bundled with the template are demonstration assets. Replace them with screenshots from the target product before publishing, and verify whether any product, customer, or personal data needs to be anonymized.
Many shot recipes in this library were distilled by studying the motion language of outstanding official product films — including promos from ClickUp, Perplexity, Slack, Notion, Figma, Framer, Bear, Raycast, Pitch, Miro, Superhuman, and Loom. The cards document motion techniques (timing, easing, choreography) re-implemented from scratch; no footage, artwork, or brand assets from these films are included in this repository. All trademarks belong to their respective owners, and none of these companies are affiliated with or endorse this project.
Special thanks to: