video-shotcraftSkill

# video-shotcraft: Cinematic Product Video Creation System

A self-contained production toolkit for Claude Code / Codex: 104+ shot recipe cards (each with a tested Remotion implementation and demo footage), one validated full-length template ("Ink Press"), reusable Remotion components, a royalty-free audio library (149 SFX across 16 categories plus BGM), and a six-stage production workflow.

## Choose a mode before producing anything

1. **Template mode** — reuse the Ink Press template's shot structure, swapping in the new product's screenshots, copy, and branding.
2. **Autonomous creative mode** — the agent independently drives product understanding, visual direction, shot mapping, storyboard, asset capture, and final cut with no stage-by-stage confirmation.
3. **Collaborative mode** — the agent proposes direction; the user confirms at five checkpoints (brief, decisions, visual direction, shot mapping, final storyboard) before final asset capture and rendering proceed.
4. **Single shot mode** — pull one shot recipe card from the gallery and adapt its tested demo implementation to new footage, without producing a full video.

## Core production rules

- Visual language must grow from the target product's existing design system (type, spacing, color, materials) — shot cards supply motion grammar and timing only, never a borrowed look.
- Reproducing real product UI requires real captured screenshots (2x resolution, full-page plus element-level masks); hand-drawn UI is only acceptable outside product-reproduction contexts.
- Each shot carries exactly one dominant motion idea; after key information lands, let the timeline rest (feedback favors longer holds and slower pacing over busy motion).
- When background music is used, analyze true BPM/phase, write the timeline against beat notation, and verify sync error stays within 3 frames; always export both a scored and an SFX-only cut.
- Shot implementation must follow the calibrated demo source tied to each named recipe card rather than reinventing parameters from scratch.
- All randomization uses fixed-seed PRNGs keyed to element index — no `Date.now()` or unseeded `Math.random()` — so renders are reproducible frame-for-frame.
- Verify shots incrementally with `npx remotion still` during production, then run an independent final review against the project's consistency/completeness/fidelity/data-safety checklist before delivery.

## Assets

- `assets/lib/` — Remotion components (PageCam, DigitRoll, Caption, etc.) meant to be copied into a new project and modified, not imported as a library.
- `assets/scripts/capture-template.mjs` — screenshot capture script for turning a live dev server into shot-ready page assets.
- `assets/audio/` — 149 SFX in 16 categories plus BGM options, with attribution notes.
- `demos/` — self-contained reference implementations for each shot card.
- `template/` — the full Ink Press Remotion project, rendered via `npm install && npx remotion render src/index.ts AiflPromo out/promo.mp4`.
- Public shot gallery: https://vincentwei1021.github.io/video-shotcraft/