Demo Video Generator Skill

Demo Video Generator

Overview

Generate 1920x1080 demo videos with voiceover, transitions, and CSS animations from a single prompt. Orchestrates Playwright (HTML-to-frame rendering), FFmpeg (compositing and transitions), and Edge TTS (neural voiceover) MCP servers.

Prerequisites

Python 3.11+ and uv package manager
FFmpeg installed (ffmpeg -version)
Playwright chromium browser (uv run playwright install chromium)
Internet connection for Edge TTS voice synthesis

Instructions

Install the framecraft plugin from the marketplace:

claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus

Quick Start

uv run python framecraft.py init my-demo        # scaffold a project
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4  # quality check

MCP Orchestration

When Playwright, FFmpeg, and Edge TTS MCP servers are available, framecraft orchestrates them directly for maximum control over each frame and audio segment.

Pipeline Fallback

When MCP servers are not available, framecraft runs an atomic CLI pipeline that handles everything in one call.

Workflow

Story design -- Choose a narrative arc (problem-solution, hero journey, before-after)
Scene authoring -- Write HTML scenes with CSS animations, or use built-in templates
Rendering -- Playwright captures frames, Edge TTS generates voiceover, FFmpeg composites

Output

1920x1080 MP4 video with voiceover and transitions
Individual scene previews for iteration
Validation report for quality assurance

Error Handling

| Error | Cause | Fix | |-------|-------|-----| | ffmpeg: command not found | FFmpeg not installed | Install via brew install ffmpeg or system package manager | | playwright._impl._errors.Error | Chromium not installed | Run uv run playwright install chromium | | edge_tts.exceptions.NoAudioReceived | TTS service unavailable | Check internet connection; retry after a few seconds | | FileNotFoundError: scenes.json | Missing scene config | Run uv run python framecraft.py init my-demo first | | Blank or black frames | HTML scene rendering failed | Check HTML syntax and ensure assets are accessible |

Examples

{
  "scenes": [
    {
      "title": "Meet YourApp",
      "subtitle": "The smarter way to manage tasks",
      "narration": "24 tasks. One dashboard. Zero stress.",
      "voice": "en-US-AndrewNeural",
      "bullets": ["Smart priorities", "Team sync", "One-click reports"],
      "duration": 0
    }
  ],
  "output": "demo.mp4",
  "width": 1920, "height": 1080,
  "voice": "en-US-AndrewNeural",
  "transition": "crossfade"
}

duration: 0 = auto-detect from TTS length + 1.5s buffer.

Resources

Source repository with templates and pipeline: github.com/vaddisrinivas/framecraft
Edge TTS voice list
Playwright documentation
FFmpeg documentation

Agent Skills: Demo Video Generator

Install this agent skill to your local

Skill Files