demo-promolisted
Install: claude install-skill waseemnasir2k26/skynetlabs-all-claude-code
# Demo-Promo — Screencast → Branded Engagement Promo
End-to-end pipeline that turns a long raw screen-recording into a tight, branded, voiced promo. **Landscape 16:9** (LI / YouTube / FB / X). For 9:16 reels use `reel-studio` instead.
Proven on: `Videos/2026-05-29_claude-autopublish_FINAL.mp4` (8:12 raw → 1:52 promo).
## When to use
Raw demo/screencast + user wants it "polished", "perfect", "engaging", with hook / heading / voiceover / music. NOT for talking-head vertical reels (→ reel-studio), NOT for static social cards (→ social-stack).
## The 6-phase pipeline
1. **Probe** raw video (ffprobe): res, fps, duration, codecs.
2. **Cut + grade** — trim dead air to the keeper segments, dissolve at joins, CLEAN color grade. → `*_POLISHED.mp4` (keep as backup; original audio).
3. **VO** — write ~200-260 word script narrating the demo → ElevenLabs TTS → loudnorm to stereo WAV.
4. **Sync** — faster-whisper transcribes the VO → segment timestamps → map overlays to narration beats.
5. **Overlays** — hook card + rotating top purpose-strap + image PiP inserts + chip strip + benefit callout + outro CTA card.
6. **Mix + mux** — continuous cinematic BGM (looped + dynaudnorm) sidechain-ducked under the VO; concat hook+main+outro; mux. → `*_FINAL.mp4`.
`recipes/build_promo.py` is the runnable orchestrator — edit the CONFIG block at the top and run. It encodes every gotcha below.
## Engagement layer (why each element earns its place)
- **Hook card (0-3s)** — pattern-interrupt headline