ray-broll

Generate editorial paper-collage B-roll videos and narrated explainer clips from spoken scripts.

160|18|Updated Jul 13, 2026
One-click install
npx skills add https://github.com/imraywang/rayskills --skill ray-broll-imraywang
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: ray-broll
Source: https://github.com/imraywang/rayskills/tree/main/skills/ray-broll
Command: npx skills add https://github.com/imraywang/rayskills --skill ray-broll-imraywang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires google-genai, httpx, Pillow, certifi, and includes scripts (resource) and references (resource) components.

What problem does it solve? Turning a spoken line or topic into a finished vertical video normally requires manual motion design, timeline editing, and repeated trial-and-error with video models. This Skill compresses that into a gated pipeline: design a visual metaphor, generate a still frame, then animate it with first/last-frame interpolation, with QA artifacts and cost tracking at every stage. ## Core Features & Use Cases - Single or batch 5-second B-roll: Convert each spoken line into one visual metaphor (max 4 object groups, semantic background color), generate a halftone paper-collage still via Gemini image models, then animate assemble-from-empty motion via Gemini Omni or fal.ai models (Kling, Seedance). - Full 45-60 second explainer videos: Build a beat map (8-10 beats with narrative roles from 14 arc templates), generate per-beat TTS narration, role-based tempo adjustment, Pillow-rendered captions and headline cards, then assemble everything with a single ffmpeg pass driven by beats.json. - Cost and quality discipline: Environment self-check, resume-only-failed-jobs dispatch, automatic cost ledger, objective QA scores (first-frame purity, end-frame similarity), and deterministic HyperFrames routing for rigid-body motions to cut generation cost. - Use Case: Give it three voiceover lines about workflow automation and receive three silent 9:16 MP4 clips with contact sheets, first-frame verification, end-frame comparisons, and QA documents—ready to drop into a video edit. ## Quick Start Ask the agent to turn this spoken line into an editorial paper-collage B-roll clip and confirm the metaphor before any video generation starts.

Frequently Asked Questions about ray-broll

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a voiceover script into a B-roll video?▼

Provide the spoken lines and the Skill designs one visual metaphor per line, generates a still frame with a Gemini image model, then animates it with first/last-frame interpolation via Gemini Omni Flash. Each stage pauses for confirmation before spending on the next.

How to make a 60-second narrated explainer video with AI?▼

The Skill splits your topic into 8-10 beats using narrative arc templates, generates per-beat video and TTS narration, applies role-based tempo adjustment with ffmpeg atempo, renders captions with Pillow, and assembles everything from a beats.json manifest in one ffmpeg pass.

What video models does this workflow support?▼

Google's gemini-omni-flash-preview is the default for first/last-frame interpolation. Through fal.ai it also supports kling-o3-standard, kling-o3-pro, seedance-2.0, and seedance-2.0-fast—only models with explicit end-frame parameters are accepted.

Why does the video first frame not match the background color?▼

Generated stills always render slightly darker than the prompt's hex value. The prepare_frames.sh script samples the actual background color from the finished image and builds the empty first frame from that measured value, preventing a color jump at the video start.

When should I not use first/last-frame video generation?▼

Avoid it when you need per-layer control, editable timelines, or frame-by-frame positioning, since interpolation produces a one-shot non-editable clip. Use HyperFrames deterministic animation for rigid slide-in motions, or live-action tools for real-person footage.