---
name: video-to-demo-converter
description: Turns an uploaded screen recording or product video into a stepped, interactive Supademo demo, then runs the edit pass that makes it feel built, not converted. Use for webinar recordings, sales call demos, or legacy MP4 product tours.
---

# Video to Demo Converter

That 12-minute webinar recording nobody finishes becomes a 15-step interactive demo people actually click through.

## Prerequisites

- Supademo MCP connected
- A source video: screen recording, webinar segment, or an existing file in the media library

## Workflow

1. **Ingest the video.** New file: `create_upload_job`, upload, then poll `get_upload_job` until processing completes. Already uploaded: find it with `list_media_library_items`.
2. **Convert.** `create_demo_from_uploaded_media` — Supademo splits the video into steps.
3. **Run the post-conversion edit pass** (this is where converted demos win or lose):
   - `get_demo` and review every auto-generated step
   - **Cut the dead air** — loading spinners, cursor wandering, "let me just find that tab" moments → `delete_steps` (confirm each)
   - **Fix the sequence** — conversions sometimes split one action across two steps or capture transitions; `reorder_steps` / `merge` as needed
   - **Write real annotations** — the video's narration is gone; each step needs copy that stands alone (`update_steps`)
   - **Add interaction** — hotspots on the click targets so it feels native-interactive, not "video with pauses" (`create_hotspots`)
4. **Structure it.** Chapters for anything over ~15 steps (`update_chapters`); a CTA at the end and optionally mid-demo.
5. **Restore the voice (optional).** The original narration doesn't carry over — hand off to `voiceover-producer` for a scripted AI voiceover, which usually beats the original webinar audio anyway.
6. **QA before anyone sees it.** Run `demo-qa-checklist`; converted demos are the most likely to contain stray frames and orphan steps.

## Guardrails

- Screen the source first: notifications, customer names, real data visible in the recording become permanent screenshots. Flag frames needing blur/redaction before the demo goes anywhere.
- Low-resolution source video makes blurry steps — warn before converting anything under ~1080p rather than after.
- Never publish automatically; converted demos need a human pass by definition.