app-demo-agent

Files (2)

• SKILL.md
• extract_frames.py · scripts/

SKILL.md (first lines)

# App Demo Producer

Turn raw screen recordings into polished app demo videos with AI-generated voiceover, device frames, and background music.

**This is an orchestrator skill** that combines:
- Screen recording analysis (FFmpeg frame extraction + Claude vision)
- Voiceover script generation (Claude)
- Device framing (device-framer)
- Voice synthesis (Gemini TTS / OpenAI TTS / ElevenLabs)
- Background music (Lyria / Suno / Udio)
- Final assembly (FFmpeg via media-utils)

## Workflow

### Step 1: Gather Requirements (REQUIRED)

⚠️ **DO NOT skip this step. DO NOT start processing until you have ALL answers.**

**Use interactive questioning** — ask ONE question at a time, wait for the response, then ask the next.

#### Question Flow

⚠️ **Use the `AskUserQuestion` tool for each question below.**

**Q1: Screen Recording**
> "I'll turn that into a polished demo! First — **where's the screen recording?**
>
> *(provide the file path, e.g., ~/Desktop/recording.mp4)*"

*Wait for response. Verify the file exists.*

**Q2: What does the app do?**
> "Give me a quick overview of what this app does and what the recording shows.
>
> *(e.g., 'It's a task management app. The recording shows creating a task, setting a due date, and marking it complete.')*"

*Wait for response. This context dramatically improves the voiceover script.*

**Q3: Device Frame**
> "Should I wrap it in a device frame?
>
> - **Yes** — iPhone 16 Pro (default)
> - **Yes, specific device** — *(I'll show you options)*
> - **No** — Keep as-is"

*Wait for response. If they want a specific device, run `--list-devices` and let them pick.*

**Q3b: Device Color** *(if device frame selected)*
> "What color for the [device name]?
>
> *(list the available colors for the selected device)*"

*Wait for response. Show the actual color options from the device registry.*

**Q3c: Background Color** *(if device frame selected)*
> "What background color for the video?
>
> - **Dark** (`#0a0a0a`) — cinematic, great for social media
> - **White** (`#ffffff`) — clean, good for presentations/websites
> - **Transparent** — for compositing *(note: output will be WebM, not MP4)*
> - **Custom** — specify a hex color"

*Wait for response. If transparent, set output format to WebM with alpha. If custom, validate the hex color.*

**Q4: Voiceover**
> "How should we handle the voiceover?
>
> - **Generate** — I'll analyze the recording and write a script that narrates what's on screen
> - **You provide** — Give me the script text
> - **None** — No voiceover"

*Wait for response.*

**Q5: Voice Style** *(if voiceover enabled)*
> "What kind of voice?
>
> **Tone:**
> - Professional / polished
> - Friendly / conversational
> - Energetic / excited
> - Calm / reassuring
> - Or describe your own tone
>
> **Gender preference:**
> - Male
> - Female
> - No preference"

*Wait for response.*

**Q6: Voice Selection** *(if voiceover enabled)*

Based on the user's tone and gender preference, recommend a specific voice and let them confirm or pick another:

> "Based on your preferences, I'd recommend **[voice name]** ([provider]). Here are some options:
>
> | Voice | Provider | Tone |
> |-------|----------|------|
> | Kore | Gemini | Friendly, clear, female |
> | Charon | Gemini | Professional, authoritative, male |
> | Puck | Gemini | Upbeat, energetic, male |
> | Aoede | Gemini | Breezy, warm, female |
> | nova | OpenAI | Friendly, natural, female |
> | onyx | OpenAI | Deep, professional, male |
>
> Want to go with **[recommendation]**, or pick a different one?"

*Wait for response.*

**Q7: Background Music**
> "Want background music? If so, what vibe?
>
> - **Modern / minimal** — clean, tech-forward
> - **Upbeat / positive** — energetic, fun
> - **Corporate / professional** — polished, confident
> - **Ambient / calm** — soft, relaxed
> - **Custom** — describe the vibe you want
> - **No music** — voiceover only (or silent)"

From michaelboeding/skills, MIT.

More from michaelboeding/skills