walkthrough-videolisted
Install: claude install-skill Ranguana/walkthrough-video
# Walkthrough video
Produces a 1080p narrated product walkthrough from any website, web app, or Electron desktop app, end to end, without a
screen-recording app: Playwright drives the target beat by beat and records it, a text-to-speech voice reads a per-beat
script, ffmpeg lines the narration up with the picture, burns captions, makes a thumbnail, and a QA script proves the
timing. Everything is driven by two files in the project: `walkthrough.config.json` and `beats.json`. The scripts in this
skill folder are generic; nothing about the target is hard-coded.
Skill folder: `~/.claude/skills/walkthrough-video/` (referred to below as `$SKILL`). Scripts: `$SKILL/scripts/{record,tts,assemble,qa,stills}.mjs`.
## Prerequisites (check once per machine)
```bash
node --version # 22+
ffmpeg -version && ffprobe -version # any recent build; libass is NOT required (captions are burned as PNG overlays)
cd "$SKILL" && npm install && npx playwright install chromium
```
### Narration engine
Two engines, picked automatically:
| Engine | When it is used | Cost |
|---|---|---|
| `elevenlabs` | `ELEVENLABS_API_KEY` **and** `ELEVENLABS_VOICE_ID` are set | billed per character |
| `say` | no credentials found (macOS only) | free, offline |
Force one with `--engine say` / `--engine elevenlabs`, or `"voice": { "engine": "say" }` in the config. `say` is the right
default for drafts, internal builds and CI; ElevenLabs is worth it for anything published. On Linux/Windows wit