Skip to content

gooseworks-ai/goose-skills / skills/video/render-vo-anchored-motion-listicle

render-vo-anchored-motion-listicle

Verified

Assemble 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.

FileKindSize
SKILL.mdskill md6.1 KB
scripts/PIPELINE.mdmarkdown7.0 KB
scripts/README.mdmarkdown3.8 KB
scripts/config.example.jsonconfig9.7 KB
skill.meta.jsonconfig189 B
tests/smoke-test.mdmarkdown1.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" }
  }
}
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: 323kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall