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/README.md

View on GitHub
# render-3d-product-showcase scripts — the FREE assembly

`render-3d-product-showcase` is the **deterministic, free assembly stage** of the 3D
product-showcase format. The paid stages are separate capabilities:

- **the styled hero** (identity lock) — `create-image-fal` (nano-banana edit) restyles the
  brand's REAL product photo onto the seamless brand-color studio set. This is the seed for
  Beats 1 & 2 and the fallback end-card background. The product geometry is the real product,
  never AI-invented.
- **Beats 1 & 2** (hero rotation + macro push-in) — `create-video-fal` image-to-video seeded on
  that styled hero.
- **Beat 3** (physics reveal) — `create-video-fal` Veo3 i2v seeded on Beat 1's last frame.
- **the bed** — `create-music-elevenlabs` (`force_instrumental` true).

There is **no Higgsfield / Marketing Studio** in this format; every paid call routes through the
fal-proxy / elevenlabs-proxy so the call is charged to your GooseWorks credits. This capability spends nothing: given the
four delivered beats + the brand wordmark it stitches the finished master. Re-cuts (a swapped end
card, a re-timed beat, a re-mixed bed) reuse the existing beats and spend nothing.

`config.example.json` is the worked example (Quillmere Pen Co. "Meridian 14", ~15s 720×1280).
`build_endcard.py` and `build_masters.py` are the runnable free assembly (below). `PIPELINE.md`
maps every config block to its source step.

## 1. Beat 1 last-frame extract — the shared anchor

Extract Beat 1's last frame once (`ffmpeg -sseof -0.1 -i beat1.mp4 -frames:v 1
beat1_last_frame.png`). It is the shared anchor: it seeds the Veo3 Beat 3 (paid, upstream) AND
backs the Beat 4 end-card hyperframe. Extracting it once keeps the product + lighting identical
across the reveal and the close, so the geometry never AI-drifts.

## 2. End card — `build_endcard.py` (Playwright hyperframe, no AI text)

```
build_endcard.py --bg beat1_last_frame.png --headline "YOUR SANCTUARY AT HOME" \
    --wordmark brand-logo.svg --out endcard.png [--headline-size 86] [--headline-color auto]
```

Beat 1's stilled last frame + a scrim + a serif headline (`--headline-font`, Playfair Display by default) + the brand's **REAL** wordmark
(SVG inlined and recolored, or a PNG). It renders at 1080×1920 via `scripts/shoot.js` (Playwright)
then ffmpeg-scales to 720×1280 (matching the viewport to the output dims clips the right edge).
The brand text is **never** AI-rendered — a diffusion model garbles a wordmark. `--headline-color
auto` picks warm-white on a dark/saturated bg and dark ink on a light/pastel bg. The headline font loads
from Google Fonts (bundle the .ttf for offline determinism). If the resolvable Playwright wants an
uninstalled browser build, `export PW_CHROME=<installed Chromium binary>`.

## 3. Assemble + mix — `build_masters.py` (per-beat normalize + hard-concat + music)

```
build_masters.py --config config.json --clips working/clips --endcard endcard.png \
    --music working/music.mp3 --out working/master.mp4
```

Reads the config, then for each beat: **trims to its window** (`beats[].duration_sec`, with
`beats[].trim_start` — defaults to 1.0s for the Veo3 reveal so its 8s take lands on rise → peak →
early settle), normalizes to the brand canvas (strip the i2v model's auto-audio with `-an`, scale
+ pad to 720×1280 with the brand `bg` pad color, 24fps, yuv420p, crf 18), and — for the end card —
holds the still for its duration. The normalized segments are hard-concatenated (concat demuxer)
in beat order — no dissolves. `reveal_variant == rotation_only` skips Beat 3 automatically.

Then it mixes one ElevenLabs instrumental bed under the concat: `afade` in 0.3s / out 0.6s +
`loudnorm I=-16 TP=-1.5 LRA=11`, `apad` + atrimmed to the master duration. Music-only — no VO, no
second bed. Output is a 720×1280 h264 + aac master (~15s). Deterministic, no paid calls, no keys.
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