Skip to content

Back to the catalog

Vincentwei1021/video-shotcraft
github.comrepo

Vincentwei1021/video-shotcraft

video-shotcraft is an installable agent skill for Claude Code and Codex that storyboards, animates, and sound-designs cinematic product promo videos using Remotion, with a library of 157+ shot recipe cards, 214+ motion previews, and a complete production template (Ink Press). It ships a post-delivery "CapCut-style" editing workbench for adjusting shots/captions/SFX and can export finished films as editable JianYing (CapCut CN) drafts, alongside a sibling skill, video-talkcraft, for voice-synced narration videos.

TL;DR An agent skill that lets Claude Code/Codex generate, edit, and export cinematic product-promo videos via Remotion.
Document

What it claims

A Claude Code / Codex skill that drives Remotion to produce product promo videos from real page captures. The README gives inconsistent counts for the shot library. The headline says 157 recipe cards and 214 previews. The 2026-08 changelog says it grew "from 104 to 152 cards / 209 previews". The workbench text mentions 216 demo motions. Expect roughly 150+ cards, not an exact figure.

The bundled Ink Press template is:

  • 36.2 s long
  • 1920×1080 at 30 fps
  • 10 shots
  • styled with 2.5D real-page camera moves and a fully pinned SFX pass

The workbench claims its preview and render are "frame-identical (pixel-parity verified)".

How it works

  • SKILL.md is the agent entry point. references/ holds the pipeline, shot cards in 10 functional categories, sequence patterns, visual QA rules (aesthetic-rules.md), beat-sync and sound-design methodology. demos/ has a matching Remotion component per card.
  • Demo components live at demos/<category>/<name>/<Component>.tsx. Each is deterministic and driven by a normalized progress t. Copy in them is neutral placeholder text, and a single ACCENT colour variable controls branding.
  • If you name no shot card, the skill first offers the Ink Press template and asks whether to use it. Otherwise it builds from the cards you name, such as deck-deal-flyin or row-embed.
  • Audio comes with 5 BGM tracks and 149 SFX in 16 categories. The recommended approach is to pick the category first, then the timbre.
  • After delivery you have two paths:
  • Workbench (Vite + Remotion Player). It splits the film into shot, transition, caption and SFX tracks. You can edit copy, fonts and colours, trim or speed-ramp clips, drag in library motions, switch among 9 themes while keeping edits, and re-render with Remotion.
  • JianYing draft export. Each shot is cut separately, captions become native text tracks, and SFX and BGM go on separate audio tracks.
  • The shot cards were distilled from official promos by ClickUp, Notion, Figma, Raycast, Linear-style peers and others. The README says these are re-implementations of timing and easing only, with no footage or brand assets.

How to use it

npx skills add Vincentwei1021/video-shotcraft

Manual install:

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

Open the workbench after delivery:

node workbench/scripts/open.mjs <project>

Example prompt: "Use video-shotcraft to make a promo for my product with the Ink Press template."

Headless Linux rendering was tested on 2 cores with Node 22. You need three fixes:

  • Pass --concurrency=1. Otherwise you get "Maximum for --concurrency is 2".
  • Use a chrome-headless-shell binary. System Chromium fails because old headless mode was removed.
  • If remotion.media is blocked, pass --browser-executable=<path-to-local chrome-headless-shell>.

Limits

  • Remotion licence: free for individuals and small teams, but companies may need a paid licence. Check this before commercial adoption.
  • Bundled audio: sourced from Mixkit under its free commercial licence. Per-file terms are in ATTRIBUTION.md.
  • JianYing export: verified only on JianYing Pro 11.2 for macOS. The Windows installer is marked untested.
  • Template screenshots: these are demo assets. Replace them before publishing, and check for customer or personal data.
  • Scope: the skill mainly targets web and desktop product promos. Only one complete template ships, with "more on the way".
  • Docs language: the detailed workbench guide is in Chinese.

Organisations named here

  • Claude Code
  • JianYing
  • Mixkit

Technologies named here

  • Claude Code
  • Codex
  • Node.js
  • Remotion