gooseworks-ai/goose-skills / skills/video/render-creator-pip-listicle
render-creator-pip-listicle
VerifiedAssemble a creator picture-in-picture product-listicle ad from a config. The creator stays full-frame for every beat (voice and lips generated together), and each product beat carries three overlays for the whole beat: a title pill, the product demo in a rounded picture-in-picture window (the brand's muted UGC clip, or its UI still or screen recording), and a product card with thumbnail, number, category and name. Hook and CTA beats show the creator with the title pill only. It builds one overlay image per beat, composites it on the creator clip, concatenates the beats and burns timed captions last. Free, deterministic assembly; the creator anchor and talking clips come from create-image-fal and create-video-fal. Use for the creator-pip-listicle format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 8.2 KB |
| scripts/PIPELINE.md | markdown | 8.3 KB |
| scripts/README.md | markdown | 5.8 KB |
| scripts/config.example.json | config | 12.2 KB |
| skill.meta.json | config | 182 B |
| tests/smoke-test.md | markdown | 2.5 KB |
scripts/config.example.json
View on GitHub{
"_comment": "Worked example (the Pantrywise Kitchen build) — copy the STRUCTURE and field names, never the creative values. Creative fields — creator.descriptor, creator.realism (setting words), beats[].dialogue (tone), title, palette — come from the format recipe's choices (creator, setting, tone) and the brand; never copy them as defaults. The demo combination was a home-cook creator at a kitchen counter with a chatty, enthusiastic tone. Pantrywise Kitchen '5 tools that replaced my whole utensil drawer' creator-pip-listicle — THE WORKED EXAMPLE. Copy to config.json and edit. A ~46s 9:16 (1080x1920, 30fps) AI-creator talking-head PRODUCT LISTICLE with NATIVE Seedance audio: an AI creator counts down 5 Pantrywise products, and the creator stays FULL-FRAME the WHOLE time — there is NO cut to a full-frame product shot. On each product beat three persistent overlays ride on top of the full-frame creator for the whole beat: (1) a title pill top-center (carries the listicle title), (2) the DEMO in a rounded PiP window top-right (the brand's real UGC clip MUTED — or, for a no-UGC brand, the product's own autocropped UI still / screen-recording sized to fill the window), (3) a product card pinned bottom (rounded thumbnail + 'N · CATEGORY' small-caps + serif product name). Hook + CTA are the creator full-frame with the title pill only. Voice + lips are generated TOGETHER in one Seedance take per beat (no separate VO, no lip-sync bolt-on); Pantrywise-green 2-word captions burned LAST as PIL PNG overlays. Pipeline: (1) lock the conversational beat script -> native-beats.json; (2) lock the creator anchor (Seedream v5 Pro candid portrait, realism-gated); (3) one native Seedance clip per beat (generate_audio=ON, SAME seed); (4) FREE demo-PiP prep (autocrop) + product cards; (5) FREE single-shot full-frame composite (build the per-beat overlay PNG, cover-scale + overlay, native audio kept); (6) FREE stitch + PIL-PNG caption burn. Master 1080x1920 h264+aac, ~46s. See scripts/PIPELINE.md for the source steps.",
"brand_name": "Pantrywise Kitchen",
"campaign": "5 tools that replaced my whole utensil drawer",
"title": "5 tools that replaced my whole utensil drawer",
"width": 1080,
"height": 1920,
"fps": 30,
"aspect_ratio": "9:16",
"duration_sec": 46,
"listicle": {
"count": 5,
"hook_pattern": "N products that replaced my whole [X]"
},
"beats": [
{"name": "00-hook", "dialogue": "So — five kitchen tools that quietly replaced my entire utensil drawer.", "duration": 6, "pip": null, "card": null, "badge": null, "show_title": true},
{"name": "01-foldboard", "dialogue": "First, the Fold Board. Cutting board and colander in one, I just rinse and fold it.", "duration": 8, "pip": "01-foldboard", "card": "01-foldboard", "badge": 1, "show_title": true},
{"name": "02-spoonula", "dialogue": "Then the Spoonula Pro. I'm hooked — it stirs, scrapes, and serves pasta.", "duration": 7, "pip": "02-spoonula", "card": "02-spoonula", "badge": 2, "show_title": true},
{"name": "03-clipscale", "dialogue": "The Clip Scale snaps onto any bowl and weighs as you pour.", "duration": 7, "pip": "03-clipscale", "card": "03-clipscale", "badge": 3, "show_title": true},
{"name": "04-peeler", "dialogue": "Pocket Peeler Pair peels and juliennes together — two passes and dinner is prepped.", "duration": 7, "pip": "04-peeler", "card": "04-peeler", "badge": 4, "show_title": true},
{"name": "05-grinder", "dialogue": "And the Twist Grinder with the Herb Keeper keeps spices fresh.", "duration": 6, "pip": "05-grinder", "card": "05-grinder", "badge": 5, "show_title": true},
{"name": "06-cta", "dialogue": "Clear the drawer. Keep the good stuff. Seriously.", "duration": 5, "pip": null, "card": null, "badge": null, "show_title": false}
],
"_note_beats": "duration = clamp(ceil(words / 2.3) + 1, 4, 11) s (Seedance native pace ~2.3 words/s). Hook + CTA carry no PiP/card/badge (title pill only). Each of the 5 product beats is ONE continuous full-frame creator shot with three persistent overlays for the whole beat: the title pill (top), the demo PiP (top-right), and the product card (bottom) with a rank number (1..5). In the demo the Clip Scale (03) has no clean e-comm photo -> its card thumbnail falls back to a branded brand-color tile, not an AI product render.",
"creator": {
"_comment": "ONE creator anchor, generated FRESH with Seedream v5 Pro (create-image-fal, model `bytedance/seedream/v5/pro/text-to-image` — NO `fal-ai/` prefix), locked once and threaded (with the SAME Seedance seed) into every native clip so the face holds. CRITICAL — Seedance 2.0's partner-validation gate REJECTS photoreal faces from gpt-image-2 AND Seedream v4 ('may contain likenesses of real people'); a Seedream v5 Pro face PASSES. Use a FRESHLY generated image (reusing an existing photoreal face also trips the gate). Realism-gated.",
"anchor": "assets/characters/anchor.png",
"method": "anchor-ref",
"image_model": "bytedance/seedream/v5/pro/text-to-image",
"realism": "plain, calm, candid head-and-shoulders portrait at a home kitchen counter — un-retouched skin (visible pores, faint freckles, fine lines, slightly uneven tone), natural stubble, no perfect teeth, soft even window daylight. AVOID 'beautiful/perfect/8k/hyperreal/studio'.",
"setting": "a lived-in home kitchen counter, soft window daylight",
"descriptor": "Man ~34, light olive skin, short beard, rolled-up flannel sleeves and a plain canvas apron, relaxed friendly delivery to camera.",
"_descriptor_note": "descriptor comes from choices.creator and setting from choices.setting — these are the demo creator, not defaults."
},
"clip_engine": {
"_comment": "ONE Seedance 2.0 reference-to-video call PER BEAT with generate_audio=ON — voice + lips generated TOGETHER (no separate VO, no lip-sync bolt-on). Dialogue INLINE in the prompt. SAME seed across beats off the creator anchor. 720p default deliverable. BILLING: a REJECTED submit STILL bills via the fal-proxy — pre-flight ONE test clip (the hook) before firing the batch. Presigned anchor URLs expire ~1h -> re-host if a batch runs long. Intermittent fal 'User is locked: Exhausted balance' is the proxy's upstream account (not GooseWorks credits) -> retry with backoff.",
"provider": "fal",
"model": "bytedance/seedance-2.0/reference-to-video",
"mode": "reference-to-video",
"resolution": "720p",
"native_audio": true,
"seed_locked": true,
"duration_formula": "clamp(ceil(words / 2.3) + 1, 4, 11)"
},
"pip": {
"_comment": "The DEMO in a rounded window top-right, played picture-in-picture for the whole product beat with audio MUTED (the creator beat's native audio is the only voice). It's the brand's REAL existing UGC ad (one per product beat, NEVER AI-regenerated) — OR, for a brand with NO UGC (B2B/SaaS), the product's own demo: a real screen-recording, or an autocropped high-res product-UI/dashboard still. AUTOCROP the demo (trim transparent/near-white margins) and size the window to the cropped content's aspect ratio so it FILLS the window (no letterbox whitespace); a WIDE screenshot -> a SHORT + WIDE window. Source: source/pip-candidates/pip-<slug>.mp4 (UGC) or working/demo/demo-<slug>.png (product-UI still).",
"content_source": "source/pip-candidates/pip-<slug>.mp4 (real UGC clip) OR working/demo/demo-<slug>.png (autocropped product-UI still / screen-recording)",
"position": "top-right",
"top_y": 175,
"right_margin_px": 30,
"max_w": 520,
"max_h": 600,
"fit": "AUTOCROP to remove transparent/near-white margins, then size the window to the cropped content's aspect ratio so it FILLS the window (no letterbox whitespace).",
"border": "white hairline ~5px, rounded ~26px, soft drop shadow",
"tag": "a small dark '▶ DEMO' pill bottom-left of the window (a real UGC clip may instead show its view-count badge; do NOT fabricate view counts for a product demo)",
"audio": "MUTED"
},
"product_cards": {
"_comment": "FREE bottom-pinned card PNG pinned on the whole product beat: rounded product/UI thumbnail LEFT, then 'N · CATEGORY' (rank + short category, brand-green, small caps) and the product NAME in a serif face (Georgia/Times) below. From the real product photo (or a brand-green 'pantrywise' tile if no photo). Script: working/scripts/render_product_cards.py.",
"engine": "pil",
"script": "working/scripts/render_product_cards.py",
"card_h": 300,
"palette": { "accent": "#2F7D5B", "paper": "#F7F5EE", "ink": "#1E2621" },
"output": "assets/overlays/product-card-<slug>.png",
"no_photo_fallback": "brand-green tile with 'pantrywise' wordmark in place of the thumbnail"
},
"title_pill": {
"_comment": "PERSISTENT title pill top-center — faithful to the format reference, which carries the listicle title the whole reel. ON by default (this format's identity). A brand text bar rendered once as a PNG at top-center; keep the copy short so it fits one line.",
"on": true,
"asset": "assets/overlays/title-pill.png",
"position": "top-center",
"top_y": 55
},
"rank_badge": {
"_comment": "A counting rank number (1..5) rendered on the product CARD (badge circle / 'N ·' prefix) on product beats.",
"on": true,
"anchored_to": "card"
},
"composite": {
"_comment": "FREE single-shot full-frame composite: each beat is ONE continuous full-frame creator shot with persistent overlays (NO cut to a full-frame product shot). Per beat: build ONE full-1080x1920 transparent overlay PNG (title pill on all beats; + demo PiP top-right + bottom product card + rank number on product beats), scale the creator clip to 1080x1920 (cover), overlay the beat's overlay PNG for the WHOLE beat, keep the native audio. PiP audio muted. Script: working/scripts/composite_pip.py.",
"engine": "ffmpeg",
"script": "working/scripts/composite_pip.py",
"per_beat_shots": 1,
"model": "creator FULL-FRAME the whole beat + persistent overlays (title pill + demo PiP top-right + product card bottom). NO cut to a full-frame product shot.",
"overlay": "Build ONE full-1080x1920 transparent overlay PNG per beat (title pill; + PiP + card on product beats; title only on hook/CTA), then overlay it on the creator clip (scaled cover to 1080x1920) for the whole beat. Native audio preserved."
},
"stitch": {
"_comment": "FREE. Concat the per-beat composites @ 30fps / yuv420p -> the pre-caption master. Probe durations with `ffprobe -of csv=p=0` (NOT `default=nk=1:np=1`, which errors on some builds).",
"engine": "ffmpeg-concat-demuxer",
"fps": 30,
"pix_fmt": "yuv420p",
"output": "finals-native/master-pip.mp4"
},
"captions": {
"_comment": "Burned LAST as timed PIL PNG overlays (this ffmpeg has NO libass — no subtitles/ass filter). White ~2-word chunks with the brand-green accent underline, positioned CLEAR of the top-right PiP and the bottom card. Timed DETERMINISTICALLY from the known per-beat script (the fal-ai/whisper proxy is unreliable, 900s timeouts — do NOT depend on it); the known script is the brand-correct source so brand tokens are always spelled right.",
"on": true,
"engine": "PIL PNG overlays (overlay=...:enable='between(t,s,e)')",
"style": "white ~2-word chunks, brand-green underline bar, black stroke",
"position": "mid-to-lower, clear of the PiP (top) and card (bottom)",
"source": "the known per-beat script, distributed across each beat's time window (deterministic)",
"last": true
},
"post_production": {
"native_audio": { "default": "on", "note": "the Seedance take's native voice IS the bed (no separate VO); PiP audio muted; the creator clip's native audio plays continuous across the whole beat" },
"captions": { "default": "on", "note": "white ~2-word chunks, brand-green accent, PIL PNG overlays, deterministic from the known script, burned LAST, clear of PiP+card" },
"title_pill": { "default": "on", "note": "persistent brand title pill top-center — this format's identity" },
"rank_badge": { "default": "on", "note": "counting rank number (1..5) on the product card on product beats" }
}
}
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: 322k | 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 |