product-demo-video

name	product-demo-video
description	Generate 2-minute product demo videos for technical projects (GitHub repos, APIs, technical products). Runs parallel build options with structured critic review. Use when demoing code, explaining architecture, or creating explainer videos.
metadata	{"clawdbot":{"emoji":"🎬"}}

Product Demo Video

Generate 2-minute product demo videos for technical projects with parallel build options and structured critic review.

When to Use

• Demoing a GitHub repo, API, or technical product
• Need professional explainer video quickly
• Want multiple approach options (animated vs simple)

Workflow (7 Phases)

DISCOVERY → SCRIPT → PARALLEL BUILD → PARALLEL CRITICS → ITERATE → FINAL → DELIVER
   │           │           │                │              │          │         │
 5-10m      10-15m      30-60m           10-15m        0-3 loops   gate    ship it

---

Phase 1: Discovery

Clone and analyze the repo:

gh repo clone <owner/repo> /tmp/<repo>

Extract:

• What it does (1 sentence)
• Who it's for
• 3-5 key features
• Architecture/flow
• Visual assets (logos, diagrams)

Ask (or use defaults):

Question	Default
Duration	2 min
Audience	Mixed (tech + business)
Tone	Professional-conversational
Format	Animated explainer

---

Phase 2: Script

Use references/script-template.md structure:

Scene 1: Hook (0:00-0:15) — Problem statement
Scene 2: Context (0:15-0:30) — Why this matters
Scene 3-5: Features (0:30-1:30) — 3 key capabilities, 20s each
Scene 6: Technical (1:30-1:50) — Architecture/credibility
Scene 7: CTA (1:50-2:00) — What to do next

Guidelines:

• 150 words/minute
• Max 20 words/sentence
• Active voice
• Concrete over vague

---

Phase 3: Parallel Build

Spawn 2 sub-agents to build options simultaneously:

// Option A: Remotion (animated)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Build animated demo video using Remotion.
  
  Script: [paste script]
  Voice: Use ElevenLabs, voice ID CcEB0ARKH8qIyzh2I1OR
  Output: /tmp/demo-video/option-a.mp4
  
  Approach:
  1. Generate voiceover per scene (ElevenLabs API)
  2. Create Remotion project with scene components
  3. Sync animations to audio timing
  4. Render at 1080p 30fps`
})

// Option B: Slides + ffmpeg (simple)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `Build slide-based demo video.
  
  Script: [paste script]
  Voice: Use ElevenLabs, voice ID CcEB0ARKH8qIyzh2I1OR
  Output: /tmp/demo-video/option-b.mp4
  
  Approach:
  1. Generate voiceover (ElevenLabs API)
  2. Create slides with Puppeteer (HTML → PNG)
  3. Combine with ffmpeg, sync to audio
  4. Add simple transitions`
})

Wait for both. Present options to user or auto-select based on quality.

---

Phase 4: Parallel Critics

Spawn 2 critic personas (see references/ for full rubrics):

// Business Critic
sessions_spawn({
  label: "critic-business",
  task: `Review demo video as Business Critic "Mike".
  
  Video: [path]
  Script: [content]
  
  See references/critic-business.md for full persona and rubric.
  
  Score: Clarity, Professionalism, Business Value (1-10 each)
  Output: Structured review with overall score and specific fixes.`
})

// Technical Critic  
sessions_spawn({
  label: "critic-technical",
  task: `Review demo video as Technical Critic "Senior Engineer".
  
  Video: [path]
  Script: [content]
  
  See references/critic-technical.md for full persona and rubric.
  
  Score: Technical Accuracy, Credibility, Completeness (1-10 each)
  Output: Structured review with overall score and specific fixes.`
})

---

Phase 5: Iterate

Quality gates:

Gate	Action
Both critics ≥7.5, no Critical issues	→ Ship
Any critic <7.0 OR Critical issue	→ Iterate
After 3 iterations, still failing	→ Escalate to human

Iteration loop:

1. Collect all Critical/Important issues
2. Fix in order of severity
3. Re-render affected scenes only (if possible)
4. Re-run critics

---

Phase 6: Final Review

Before shipping, verify:

• Both critics passed (7.5+)
• No Critical issues remain
• Audio synced correctly
• All scenes render cleanly
• CTA is clear

---

Phase 7: Deliver

Output:

✅ Demo video complete!

📹 Video: demo-video-final.mp4 (2:03)
🎯 Audience: [target]
📊 Scores: Business 8.2/10 | Technical 7.8/10

Covers:
1. [Key point 1]
2. [Key point 2]  
3. [Key point 3]

Files saved to: [location]

Deliver to:

• Slack channel (if specified)
• Save to workspace/outputs/

---

Tools & Dependencies

Tool	Purpose	Required
ElevenLabs	Voiceover generation	Yes
Remotion	React video framework (Option A)	One of A/B
ffmpeg	Video processing (Option B)	One of A/B
Puppeteer	Slide screenshots (Option B)	One of A/B
sessions_spawn	Parallel sub-agents	Yes

Voice default: CcEB0ARKH8qIyzh2I1OR (Jeremy - Technical Tutorial Narrator)

---

File References

• references/critic-business.md — Business critic persona & rubric
• references/critic-technical.md — Technical critic persona & rubric
• references/script-template.md — Scene-by-scene script structure
• templates/remotion/ — Remotion project scaffold with components
• scripts/generate-voiceover.py — ElevenLabs TTS helper
• scripts/render-slides.sh — ffmpeg slide-to-video combiner