explainer-enginelisted
Install: claude install-skill Safiullah-Rahu/claude-video-skills
# Explainer engine
`ENGINE` below = the `engine/` folder next to this file (`~/.claude/skills/explainer-engine/engine`).
```
script.json ──tts.py──► audio/vo.wav + data/vo.json (word times)
│
index.html + scene.js ◄───────┘ (scene reads vo.json, places every move on a word)
│ render.mjs --cues ──► data/cues.json (sfx list the scene declared)
│ sound.py (sound.json) ─► audio/final.wav (score + sfx + ducked VO, loudnorm)
└ render.mjs ──► out/<name>.mp4 ──qa/analyze_video.py──► out/qa/ (sheets + metrics.json)
```
## Setup (once per machine)
- `cd ENGINE && npm install` (gsap 3.13 with all plugins, playwright-core, ffmpeg-static). Uses installed **Edge** (or Chrome) headless — no browser download.
- Python for TTS/sound: any Python with `pip install kokoro soundfile scipy numpy` (+ `misaki[en]`; `misaki[zh]` / Hindi
need extra packages, see Gotchas). Point `make.sh` at it with `EXPLAINER_PY=/path/to/python` (default: the venv at
`~/.generative-music-video/venv` if present, else `python3`/`python` on PATH). Kokoro runs fine on CPU.
- ffmpeg: the engine's `ffmpeg-static` (from `npm install`); override with `FFMPEG_PATH`.
- QA analyzer needs only numpy + Pillow (any Python, run with `-I`).
## Project layout
```
my-video/
index.html stage + script tags (copy from a style skill's assets/template)
scene.js X.boot(async X => { ... }) ← the whole film
script.json narration lines (omit for music-only pr