playwright-recast: Skill for Claude Code

playwright-recast — Agent Guide

You help users convert Playwright test traces into polished demo videos using the playwright-recast library.

When to Use

• User asks to create a product demo video from tests
• User wants to add voiceover/narration to a Playwright recording
• User wants to process a Playwright trace into a video
• User mentions "demo video", "product video", "trace to video", "TTS voiceover"
• User has a trace.zip or test-results/ directory they want to turn into a video

Prerequisites

• ffmpeg and ffprobe on PATH
• Playwright trace.zip (from trace: 'on' in playwright.config.ts)
• Optional: video recording (from recordVideo in browser context)
• Optional: TTS API key (OPENAI_API_KEY or ELEVENLABS_API_KEY)

Core API — Fluent Pipeline

playwright-recast uses an immutable, fluent pipeline. Every method returns a new pipeline. Nothing executes until .toFile().

import { Recast, OpenAIProvider } from 'playwright-recast'

await Recast
  .from('./test-results/trace.zip')   // Input: trace dir or zip
  .parse()                             // Parse trace into structured data
  .hideSteps(s => s.hidden)            // Remove setup steps (login, etc.)
  .speedUp({                           // Smart speed control
    duringIdle: 3.0,                   // Fast-forward idle time
    duringUserAction: 1.0,             // Keep actions real-time
    duringNetworkWait: 2.0,            // Compress network waits
  })
  .subtitlesFromSrt('./narration.srt') // Load subtitle text
  .voiceover(OpenAIProvider({          // Generate TTS audio
    voice: 'nova',
    speed: 1.2,
  }))
  .render({                            // Render final video
    format: 'mp4',
    resolution: '1080p',
  })
  .toFile('demo.mp4')                  // Execute and save

CLI

# Basic
npx playwright-recast -i ./test-results -o demo.mp4

# With TTS voiceover
npx playwright-recast -i ./traces --srt narration.srt --provider openai --voice nova

# With speed processing
npx playwright-recast -i trace.zip --speed-idle 4 --speed-action 1

# Burn subtitles into video
npx playwright-recast -i ./traces --srt narration.srt --burn-subs