claude-video-skills

Video-editing automation for Claude Code, built on Remotion. Drop a pre-cut clip (or a voiceover + idea) into projects//raw/, tell Claude what you’re making, and it takes it from there - transcription, a beat-timed graphics plan, captions, b-roll, zooms, and a full audio score, end to end.

Start here: /make-video

The unified entry point is the make-video router skill (.claude/skills/make-video/SKILL.md). Invoke it (or just ask Claude Code to “make a video”) and it asks what you’re making, then runs the right pipeline end-to-end:

Per-video runbook: EXECUTION.md · install + brand setup: SETUP.md · session state: WORKLOG.md · agent conventions: CLAUDE.md.

Not one brand - yours

This isn’t skinned to a single creator’s look. Routes A and B ship with an example “Visual OS” preset so they render something reasonable out of the box, but before your first real render, run the Brand setup flow in SETUP.md: a short back-and-forth (primary color, a second accent, fonts, anything to avoid) that Claude uses to derive a full, coherent token set and write it into the templates - once, not per video.

---

Install

# system tools
brew install node ffmpeg

# python env (shared across all engines)
python3.11 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt

# secrets - copy the template and add your key(s)
cp .env.example .env
# then edit .env and set ONE of:
#   ASSEMBLYAI_API_KEY=your_key_here
#   OPENAI_API_KEY=your_key_here

All external-tool keys go in the repo-root .env file (never in code, never committed - .env is gitignored, .env.example is the committed template). Every script loads it automatically, so you don’t export anything in your shell. Full install (including each engine’s own npm install) and the one-time brand setup: SETUP.md.

Transcription options

• Cloud (default): AssemblyAI or OpenAI Whisper - fast, no heavy install, needs one API key. AssemblyAI tags filler words with timestamps. Audio is uploaded to the provider, so avoid this for sensitive clips.
• Alternative: WhisperX - fully local, no API/key, but installs PyTorch and runs on CPU (slower on Mac). Uncomment whisperx in requirements.txt.

Faceless motion-graphics reels (motion-design-edit)

For reels with no camera at all - cream paper grid, punch-color cards, taped proof-card shots, timed to a voiceover - use the motion-design-edit skill