Your product is done and you need a promo video that doesn't look amateur. The traditional path is hiring a designer to hand-craft it in AE/Pr, or stamping one out from a template site - the former is expensive and slow, the latter looks like everyone else's. video-shotcraft offers a third path: it's an agent skill that, once installed in Claude Code or Codex, lets you point at your product and have it storyboard, animate, and sound-design a cinematic promo rendered with Remotion.
What it is
video-shotcraft (github.com/Vincentwei1021/video-shotcraft) is an open-source project by developer Vincentwei1021 (Yihao) with 3,492 GitHub stars, 295 forks, primary language TypeScript, Apache-2.0 license, created 2026-07-19, last pushed today (August 4). One-line pitch: turn 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.
It belongs to the same "agent skill" wave as book-to-skill - following the open Agent Skills standard, installed into an agent's skills directory, invoked on demand. But the direction differs: book-to-skill solves "reading," video-shotcraft solves "making video." The technical base is Remotion - an open-source framework for writing videos in React/TypeScript - so the output is programmable, reproducible TSX, not a black-box generation.
Four core capabilities: real page captures, 2.5D camera moves, beat-synced cuts, and film-grade SFX.
What's included
The repo ships not just a template but a full video-production asset library:
| Content | Description |
|---|---|
| 104 shot recipe cards | Purpose, energy, suggested duration, parameters, implementation notes, known pitfalls |
| 161 motion previews | Covering 161 styles; searchable and filterable in the online Gallery |
| Remotion implementations | Tuned TSX demos with real easing and timing parameters |
| Complete video template | A validated 36.2-second, 1920x1080, 30fps, 10-shot product promo |
| Components and assets | 2.5D page camera, captions, flash cuts, digit rolls, SFX, capture scripts |
| Production methodology | Capture, visual direction, storyboarding, sound design, beat sync, final QA |
The shot recipe cards are the core asset: each card is a reusable shot pattern (e.g. spotlight-hero-card, deck-deal-flyin, row-embed) with parameters and implementation notes that an agent can directly call and combine. The 161 motion previews are searchable, filterable, and variant-switchable in the online Gallery - pick a card, copy its name, hand it to the agent.
Built-in template: Ink Press
Don't want to assemble shots from scratch? The repo ships a validated complete template, Ink Press: 36.2 seconds, 1920x1080, 30fps, 10 shots, paper-ink-amber style, 2.5D real-page camera moves, with title cards, transitions, and a full cinematic SFX pass. One-line usage:
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. It's the fastest, most reliable path from zero to a finished film. More templates are on the way.
How to install and use
The most direct way: hand the repo link to your agent and say:
Install this skill for me: https://github.com/Vincentwei1021/video-shotcraftThe agent clones the repo and links it into your skills directory. Or use the skills CLI or do it manually:
npx skills add Vincentwei1021/video-shotcraft
# or manually
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 # CodexThen 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 template first and asks whether to use it; you can also pick shots in the Gallery before starting. For developers in China: the author maintains an AtomGit mirror (atomgit.com/VincentWei/video-shotcraft) if GitHub is hard to reach.
Three headless rendering pitfalls
Rendering on a headless Linux box (CI) hits three known walls:
- Concurrency cap:
remotion still/renderfails with "Maximum for --concurrency is 2" on low-core machines. Fix: pass--concurrency=1. - Old Headless removal: recent Chrome/Chromium dropped old headless mode; pointing Remotion at system chromium fails to launch. Fix: use a chrome-headless-shell binary instead of full Chrome.
- Blocked CDN: if remotion.media is unreachable, the automatic headless-shell download is rejected. Fix:
--browser-executable=<path-to-local chrome-headless-shell>.
With these three flags set, frame renders from the bundled template work.
Takeaway
video-shotcraft hits the high-frequency, non-trivial need for "product promo videos." Its approach isn't to duke it out with generative video models like Sora, but to distill professional video production - shot patterns, motion parameters, audio beats - into a reusable agent skill asset library that an agent assembles with Remotion, a programmable framework. The output is TSX source code: readable, editable, reproducible - its biggest difference from black-box generation.
It suits two crowds: indie devs and small teams who've finished a product and need a presentable promo but can't afford video production; and people doing scaled AI-agent video production who need a reusable shot system. The bar is using a host that supports Agent Skills (Claude Code or Codex) and being able to install Remotion locally (Node and Chrome environment). The risk is that Remotion rendering is resource-hungry and headless environments are tricky - get the three flags ready for CI.
In the trend of agent skills extending from "reading docs" to "making creations," video-shotcraft is a template for distilling professional video-production methodology into an open-source skill. 3,492 stars, Trendshift-listed, pushed today - developers are clearly using it.
References
- video-shotcraft GitHub repo: https://github.com/Vincentwei1021/video-shotcraft
- Live Gallery (161 motion previews): https://vincentwei1021.github.io/video-shotcraft/
- Remotion (video rendering framework): https://www.remotion.dev/
- AtomGit mirror (China): https://atomgit.com/VincentWei/video-shotcraft
- Star/fork/language/license data per GitHub API (verified 2026-08-04, 3,492 stars)