gooseworks-ai/goose-skills / skills/video/render-vo-anchored-motion-listicle
render-vo-anchored-motion-listicle
VerifiedAssemble a narrated motion-graphic listicle video ad from a config: a voiceover (cloned or cast, in the chosen tone) reads a numbered list while N animated web-graphic beats in one branded design system (alternating tiles, big numerals, callouts) are rendered frame by frame and timed to the voiceover's words. Optional B-roll windows (a brand clip, an AI clip or a motion graphic) give the eye a break, and captions appear only inside those windows, with the voiceover mixed over a low music bed. Free, deterministic assembly; the voiceover, music and any AI clips come from create-vo-elevenlabs, create-music-elevenlabs and create-video-fal. Use for the vo-anchored-motion-listicle format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.1 KB |
| scripts/PIPELINE.md | markdown | 7.0 KB |
| scripts/README.md | markdown | 3.8 KB |
| scripts/config.example.json | config | 9.7 KB |
| skill.meta.json | config | 189 B |
| tests/smoke-test.md | markdown | 1.6 KB |
scripts/config.example.json
View on GitHub{
"_comment": "Worked example (the Truehour 'doctor-educator' build) — copy its STRUCTURE and field names, never its creative values. Creative fields — voice.mode / voice.voice_id / voice.reference_sample (choices.narrator), the script + beats[].headline/body/callout (choices.list_angle + choices.tone), design.name / design.callout_style / design.accents / design.background_tiles (choices.visual_style; palette + fonts from the brand kit), music.prompt (choices.music), broll[].ai_prompt, brand_name / campaign / title / wordmark — come from the recipe's choices and the brand; never copy them as defaults. A ~66s 9:16 (1080x1920, 25fps, h264 crf18 + aac 192k) EXPERT motion-graphic LISTICLE where a CLONED authoritative clinician VO narrates a numbered listicle and every beat reveal is anchored to the VO's word-level timestamps. Pipeline: (1) lock the VO (ElevenLabs clone, eleven_v3, atempo) — it sets the timeline; (2) Groq whisper-large-v3 word-level -> working/whisper/words-flat.json; (3) author N hyperframe beats (HTML + Web Animations window.renderAt(t)) in ONE design system (_shared.css / _shared.js); (4) periodic color-graded B-roll windows for breath; (5) render each beat frame-by-frame via Playwright (render_hf.py, ALL beats fps 25), concat, mix the VO under a low music bed, composite + burn window-masked captions (build_master_v4.py) -> finals/truehour-v4-master.mp4. NO lipsync — the still headshot is kept only for a future lipsync variant. See scripts/PIPELINE.md for the source scripts.",
"brand_name": "Truehour",
"campaign": "doctor-educator listicle",
"title": "What your dermatologist wishes you knew",
"width": 1080,
"height": 1920,
"fps": 25,
"duration_sec": 66.0,
"aspect_ratio": "9:16",
"video_codec": "h264 crf18",
"audio_codec": "aac 192k",
"voice": {
"_comment": "Locked FIRST — the VO sets the timeline. mode 'clone' here: an ElevenLabs voice cloned from a short reference sample of the clinician (Dr. Hale, a fictional clinician), then narrated over the listicle script with eleven_v3, then atempo'd to the target pace. Word-level timestamps come from Groq whisper-large-v3 on the RENDERED VO. The clinician headshot is retained only for a FUTURE lipsync variant — this master has NO lipsync.",
"mode": "clone",
"provider": "elevenlabs",
"model": "eleven_v3",
"voice_id": "cloned-hale",
"atempo": 1.06,
"reference_sample": "voice/dr-hale-all-shorts.mp3",
"clone_script": "voice/clone_voice.py",
"narrate_script": "voice/render_listicle_v2.py",
"outputs": {
"audio": "voice/listicle-hale-v2-render.mp3",
"raw": "voice/listicle-hale-v2-raw.mp3",
"word_timings": "working/whisper/words-flat.json"
}
},
"design": {
"_comment": "ONE branded design system for all N beats. Demo look (TRUEHOUR_EDUCATOR, glass-pill callouts) — the look comes from choices.visual_style, colours/fonts from the brand kit. _shared.css holds the tokens (palette, type, alternating background tiles, decorative accents, callout style); _shared.js holds initRenderer + revealWords + easing. Alternate ONLY the background tile per beat; keep the big hero numerals, body type, accents, and callouts CONSISTENT so the reel reads as one designed piece.",
"name": "TRUEHOUR_EDUCATOR",
"heading_font": "Editorial serif (heading)",
"body_font": "Grotesk sans (body)",
"numeral_style": "big hero numeral in the brand accent color, top-left of each point beat",
"palette": ["warm cream #F6F1EA", "deep clinical teal", "brand accent coral", "soft charcoal type"],
"background_tiles": ["cream-tile", "teal-tile"],
"accents": ["hand-drawn arc underlines", "dotted rule", "small SVG plus marks"],
"callout_style": "glass-pill (frosted rounded rectangle, coral border, charcoal type)",
"shared_css": "working/hyperframes-v4/_shared.css",
"shared_js": "working/hyperframes-v4/_shared.js"
},
"beats": [
{ "id": "B01", "role": "hook", "anchor_word": "wishes", "anchor_t": 0.0, "hero_numeral": "", "headline": "What your dermatologist wishes you knew", "body": "5 things most routines get wrong.", "callout": "", "accent": "cream-tile" },
{ "id": "B02", "role": "point", "anchor_word": "first", "anchor_t": 6.4, "hero_numeral": "1", "headline": "More product isn't more results", "body": "Layering actives fights your barrier.", "callout": "Barrier first", "accent": "teal-tile" },
{ "id": "BR01", "role": "broll", "anchor_word": "", "anchor_t": 12.2, "broll_ref": "broll[0]", "_comment": "B-roll breath window — captions burn HERE only." },
{ "id": "B03", "role": "point", "anchor_word": "second", "anchor_t": 16.8, "hero_numeral": "2", "headline": "Sunscreen is the actual anti-aging step", "body": "Daily SPF beats every serum.", "callout": "SPF > serum", "accent": "cream-tile" },
{ "id": "B04", "role": "point", "anchor_word": "third", "anchor_t": 24.5, "hero_numeral": "3", "headline": "Retinol works slowly — on purpose", "body": "Twelve weeks, not twelve days.", "callout": "12 weeks", "accent": "teal-tile" },
{ "id": "BR02", "role": "broll", "anchor_word": "", "anchor_t": 32.0, "broll_ref": "broll[1]", "_comment": "Second B-roll breath window." },
{ "id": "B05", "role": "point", "anchor_word": "fourth", "anchor_t": 36.6, "hero_numeral": "4", "headline": "Fragrance is the hidden irritant", "body": "It's the first thing to cut.", "callout": "Cut fragrance", "accent": "cream-tile" },
{ "id": "B06", "role": "point", "anchor_word": "fifth", "anchor_t": 44.9, "hero_numeral": "5", "headline": "Consistency beats the fancy routine", "body": "Three steps you'll actually do.", "callout": "3 steps", "accent": "teal-tile" },
{ "id": "BCTA", "role": "cta", "anchor_word": "start", "anchor_t": 58.0, "hero_numeral": "", "headline": "Build a routine that actually works", "body": "", "callout": "truehour.example", "wordmark": "brand-assets/logos/truehour-wordmark.svg", "accent": "cream-tile", "_comment": "CTA / end beat — Truehour wordmark composited from the real SVG (NEVER AI-rendered text)." }
],
"broll": [
{ "id": "broll[0]", "source": "ai-video", "ai_prompt": "screen-free candid clinician in a bright modern clinic, shallow depth of field, no text", "query": "", "brand_clip": "", "t_start": 12.2, "t_end": 16.8, "graded": true, "captioned": true, "_comment": "Breather window. source is brand-clip | ai-video (create-video-fal, PAID — gate it) | motion-graphic. NO free stock source exists (media-proxy only wraps FAL/ElevenLabs/Whisper). If ai-video: SCREEN-FREE footage only (AI garbles on-screen UI text). Trim + color-grade to the palette. Captions burn ONLY inside this window. HOW MANY / WHERE = taste calls, not fixed." },
{ "id": "broll[1]", "source": "ai-video", "ai_prompt": "screen-free candid person, bright bathroom morning routine, shallow depth of field, no text", "query": "", "brand_clip": "", "t_start": 32.0, "t_end": 36.6, "graded": true, "captioned": true, "_comment": "Second breather window — same source options; screen-free if ai-video; graded + captioned." }
],
"captions": {
"_comment": "Built from the VO word timings (working/whisper/words-flat.json), kept ONLY inside the B-roll windows (broll[0], broll[1]), 2-word chunks, closing a cue on any >0.4s word gap. The ASS `Format:` header MUST include a `Name` field or the leading-comma bug eats the first field and captions silently drop. The motion-graphic beats are NOT captioned — their on-screen type IS the caption.",
"source": "working/whisper/words-flat.json",
"mask": "broll_windows_only",
"chunk_words": 2,
"gap_close_s": 0.4,
"ass_format_has_name_field": true,
"position": "lower-third",
"no_pill": false,
"font": "Grotesk sans Bold",
"base_color": "#FFFFFF",
"outline_px": 4
},
"music": {
"_comment": "Low ElevenLabs Music bed UNDER the VO (~0.18 vol). The VO is the spine — the bed must not fight it. No artist names in the prompt (ElevenLabs Music ToS filter).",
"provider": "elevenlabs",
"model": "music_v1",
"prompt": "Warm, minimal, editorial lo-fi bed — soft rhodes, brushed percussion, unobtrusive, clinical-calm. Sits low under a spoken voiceover.",
"bed_volume": 0.18
},
"audio_mix": {
"_comment": "VO at full, music bed ~0.18 under it. Loudnorm to -14 LUFS. No ducking needed at this bed level.",
"vo_volume": 1.0,
"music_bed_volume": 0.18,
"loudness_lufs": -14
},
"headshot": {
"_comment": "The still clinician headshot is kept for a FUTURE lipsync variant. The shipped motion-graphic + VO master does NOT use it.",
"asset": "source/hale-headshot.png",
"used_in_master": false
},
"render_engine": {
"_comment": "Each beat is an HTML hyperframe + the Web Animations API driven by window.renderAt(t); Playwright screenshots it frame-by-frame and ffmpeg encodes it. Deterministic web motion graphics, NOT i2v. ALL beats MUST share fps 25 — a mismatched-fps beat stutters at the concat seam.",
"engine": "playwright+ffmpeg",
"renderer": "window.renderAt(t) per frame -> Playwright screenshot -> ffmpeg encode",
"fps": 25,
"script": "working/render_hf.py",
"hyperframes_dir": "working/hyperframes-v4/",
"shared_css": "working/hyperframes-v4/_shared.css",
"shared_js": "working/hyperframes-v4/_shared.js"
},
"post_production": {
"voiceover": { "default": "on", "note": "the cloned/cast VO (choices.narrator) IS the spine and sets the timeline" },
"music": { "default": "on", "note": "low ElevenLabs Music bed (~0.18 vol) under the VO, style from choices.music; off if the user picks none" },
"captions": { "default": "on", "note": "window-masked (B-roll only), 2-word chunks, close on >0.4s gaps, ASS Name-field header" },
"end_card": { "default": "on", "note": "CTA beat uses the brand's real wordmark, never AI-rendered text" }
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 323k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |