video-shotcraft 🎬

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.

🎬 Showcase

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

▶️ Watch in HD on YouTube

Browse every shot card and motion preview online: Gallery
— search, filter, switch between variants, and copy selected shot-card names.

🚀 Quick start

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.

📼 Video template: Ink Press

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

▶️ Watch in HD on YouTube

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.

📦 What's included

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.

🗂 Repository structure

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 and asset notes

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.

🙏 Acknowledgements

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:

• Remotion — the React-based video framework
  that powers every demo and template here. Note that Remotion has its own
  license
  (free for individuals and small teams; companies may need a paid license).
• Mixkit — source of the SFX and music assets bundled
  under their free commercial license.
• The game-feel and animation communities whose published principles (e.g.
  Vlambeer's screenshake talks, classic animation timing) inform several cards.
• Claude Code — this library itself was built, iterated, and QA'd with an
  AI coding agent, using the same workflow the skill teaches.