Skip to content

gooseworks-ai/goose-skills / skills/video/render-3d-product-showcase

render-3d-product-showcase

Verified

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

FileKindSize
SKILL.mdskill md4.9 KB
scripts/PIPELINE.mdmarkdown5.6 KB
scripts/README.mdmarkdown3.8 KB
scripts/build_endcard.pyexecutablescript5.8 KB
scripts/build_masters.pyexecutablescript4.8 KB
scripts/config.example.jsonconfig10.8 KB
scripts/shoot.jsscript1.2 KB
skill.meta.jsonconfig236 B
tests/smoke-test.mdmarkdown1.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.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
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: 198kUpdated Claude CodeCodexVerifiedInstall