gooseworks-ai/goose-skills / skills/video/render-3d-product-showcase
render-3d-product-showcase
VerifiedAssemble a premium 3D product-showcase ad from a config — four beat clips (an orbiting hero rotation, a macro push-in, a physics reveal, a typographic close) normalized to the chosen backdrop colour, hard-concatenated in order, closed on a deterministic Playwright brand end card, and mixed under one instrumental bed at loudnorm I=-16 (music-only, no VO). Ships the runnable build_endcard.py + build_masters.py; the rotation/macro clips are create-video-fal i2v seeded on a create-image-fal styled hero, the reveal is Veo3 i2v, and the bed is create-music-elevenlabs. Use for the 3d-product-showcase format.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 4.9 KB |
| scripts/PIPELINE.md | markdown | 5.6 KB |
| scripts/README.md | markdown | 3.8 KB |
| scripts/build_endcard.pyexecutable | script | 5.8 KB |
| scripts/build_masters.pyexecutable | script | 4.8 KB |
| scripts/config.example.json | config | 10.8 KB |
| scripts/shoot.js | script | 1.2 KB |
| skill.meta.json | config | 236 B |
| tests/smoke-test.md | markdown | 1.1 KB |
scripts/PIPELINE.md
View on GitHub# PIPELINE — config → source steps
This capability ships the **recipe** (`config.example.json`) **and** the runnable free-assembly
scripts (`build_endcard.py`, `build_masters.py`, `shoot.js`). The paid stages (styled hero, i2v
beats, music) are separate media capabilities. This maps each config field to the step that
consumes it.
## Order of operations
Styled hero (identity lock) → prompts approved (Gate 1) → probe one i2v call → Beats 1+2 i2v
seeded on the styled hero → extract Beat 1 last frame → Veo3 Beat 3 reveal seeded on it → Beat 4
`build_endcard.py` → music → `build_masters.py` (trim + normalize + concat + mix) → 720×1280 master.
## Choices → config fields
Asked of the user before any paid step (recipe `choices`); `config.example.json` holds the demo's
answers as a worked example only.
| Choice | Config fields | Demo value |
|---|---|---|
| `backdrop` | `studio_look.bg` (+ pad colour), `<BG>` in `beats[].prompt`, `product_identity.step_1` | deep teal `#1F4E5A` |
| `lighting_mood` | `studio_look.lighting_preset`, `studio_look.rim_light`, `<LIGHTING>` in `beats[].prompt`, `product_identity.step_1` | `luxe_botanical_warm` |
| `reveal` | `reveal_variant`, `beats[2]` | `exploded_view` |
| `music` | `music.prompt` | minimal ambient-electronic, drop at 7s, 100 BPM |
## Field → step map
| config field | source step | phase | what it does | paid? |
|---|---|---|---|---|
| `product.hero_png`, `product_identity.*`, `studio_look.*` | `create-image-fal` (`fal-ai/nano-banana/edit`) | Hero | Restyle the brand's REAL product photo onto the seamless `studio_look.bg` set in the chosen lighting → `hero_styled.png`; host it (MCP media_upload) so i2v can seed off a public url. Locks the product's real geometry — no Marketing Studio, no PDP import. | **PAID** (cheap, ~1 image) |
| `beats[0].prompt`, `beats[0].model`, `beats[0].start_image`, `beats[0].duration_sec` | `create-video-fal` i2v (`beats[].model` — Seedance Lite default) | Beat 1 | i2v hero rotation seeded on `hero_styled.png`. A single i2v is a partial arc, not a literal 360. Result mp4 → `working/clips/beat1.mp4`. | **PAID** |
| `beats[1].prompt`, `beats[1].model`, `beats[1].start_image` | `create-video-fal` i2v (same model) | Beat 2 | i2v macro push-in seeded on the SAME `hero_styled.png` so the product reads identical. → `working/clips/beat2.mp4`. | **PAID** |
| `beats[0].produces_anchor` | `ffmpeg -sseof -0.1 -i beat1.mp4 -frames:v 1 beat1_last_frame.png` | Beat 1→3 | Extract Beat 1's **last frame** — the shared anchor: Veo3 Beat-3 seed AND the Beat-4 hyperframe background. | free |
| `beats[2].prompt`, `beats[2].start_image`, `beats[2].model`, `beats[2].generate_audio`, `reveal_variant` | `create-video-fal` Veo3 i2v (`fal-ai/veo3/fast/image-to-video`) | Beat 3 | Veo3 i2v physics reveal seeded on `beat1_last_frame.png`, `generate_audio:false`. Defaults to an 8s take (trimmed later). Skip when `reveal_variant == rotation_only`. The reveal prompt must name **where** the reveal happens. | **PAID** (priciest single call) |
| `end_card.*`, `beats[3].headline`, `beats[3].headline_size_px` | `build_endcard.py --bg beat1_last_frame.png --headline "<H>" --wordmark <wm> --out endcard.png` | Beat 4 | Playwright hyperframe: Beat 1 last frame + scrim + serif headline (`--headline-font`, Playfair Display default) + the **real** wordmark (recolored for contrast) → render 1080×1920 → ffmpeg-scale to 720×1280. | free |
| `music.*` | `create-music-elevenlabs` | Music | One ElevenLabs instrumental bed in the `music` choice (genre + BPM + drop timing), `force_instrumental`, no artist names → `working/music.mp3` (~15s). | **PAID** |
| `finalize.*`, `audio_mix.*`, `beats[].duration_sec`, `beats[].trim_start`, `studio_look.bg` | `build_masters.py --config config.json` | Assemble | Trim each beat to its window, normalize (`-an`, scale 720×1280 pad-to-`bg`, 24fps, yuv420p, crf 18) → concat demuxer → mix the bed (`afade` in 0.3s / out 0.6s + `loudnorm I=-16 TP=-1.5 LRA=11`, apad + atrimmed to master duration) → master mp4 (~15s). | free |
## Notes
- **Model surfaces:** `create-image-fal` (styled hero), `create-video-fal` i2v ×2 (Beats 1+2),
`create-video-fal` Veo3 i2v (Beat 3 reveal), `create-music-elevenlabs` (bed). Everything else
(last-frame extract, `build_endcard.py`, `build_masters.py`) is free/deterministic. **No
Marketing Studio / Higgsfield** — there is no such capability, and it would not bill the Ads
agent; Beats 1+2 are FAL i2v seeded on the styled hero.
- **Identity discipline:** the styled hero is built from the brand's REAL product photo, so Beats
1+2 carry the real geometry; Beat 3 is seeded on Beat 1's *last frame*; Beat 4 sits over Beat 1's
stilled last frame — the product + lighting carry across all four beats and are never AI-invented.
- **Reveal-prompt spatial clause is load-bearing.** A reveal prompt that doesn't say *where* the
parts or cross-sections should face lets Veo3 pop a part off at random and smear the surface.
The `config.example.json` `beats[2].prompt` shows the spatial clause.
- **Reveal-variant taxonomy:** cosmetic/liquid/fragrance → particle_disintegration; beverage OR a
water product (spa/tub/fountain) → liquid_splash; multi-part / structural → exploded_view;
large/featureless no-reveal (a tool, a solid appliance) → rotation_only (skip Beat 3).
- **Duration:** beats are 4+4+4+3 = **15s**. Veo3 fast is an 8s take → `build_masters` trims it to
the 4s window (`trim_start` default 1.0s). i2v auto-audio is stripped (`-an`) or it leaks into
the master.
- **End-card render dims:** render at 1080×1920 then ffmpeg-scale to 720×1280 — matching the
Playwright viewport to the output dims clips the right edge.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |