| name | Demo Generator |
| description | Generate a per-recording single JSON demo manifest from a .mov file using demo/demo_generator.py. |
Demo Generator Instructions
Use this skill when the user wants to bootstrap demo production files from a screen recording.
Tool
- Script:
demo/demo_generator.py
- Input: one
.mov file path
- Output: a sibling folder named after the movie stem, with one editable JSON manifest
Generated File
For input path/to/demo01.mov, output folder is path/to/demo01/ with:
demo01_demo.json
Purpose: single source of truth for script text, timing, scenes, and TTS config.
When to use: all demo authoring, timing, and sync workflows.
Commands
Dry run (no writes):
python demo/demo_generator.py path/to/demo01.mov --dry-run
Generate skeleton:
python demo/demo_generator.py path/to/demo01.mov
Overwrite existing skeleton files:
python demo/demo_generator.py path/to/demo01.mov --overwrite
Rules
- Input must be
.mov.
- Keep generated JSON as the only canonical per-demo content file.
- Prefer
--dry-run first when working in existing demo folders.
narrative_lines[].text is authoritative narration content.narrative_lines[].start_ms / end_ms are authoritative timing values.
