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/config.example.json

View on GitHub
{
  "_comment": "Quillmere Pen Co. 'Meridian 14 fountain pen (tidewater teal)' — the worked example. Copy to config.json and edit. A ~15s premium 3D product showcase: one real product floats centered on a clean seamless brand-color backdrop and sells itself across 4 beats — Beat 1 an orbiting hero rotation, Beat 2 a macro push-in on the surface detail, Beat 3 a physics reveal (reveal_variant), then Beat 4 a typographic brand close. 720x1280 9:16, music-only (no VO). IDENTITY: Beats 1+2 are create-video-fal image-to-video seeded on a create-image-fal STYLED HERO built from the brand's real product photo (real geometry, never AI-invented). Beat 3 is Veo3 i2v seeded on Beat 1's last frame. Beat 4 is a deterministic Playwright hyperframe. One ElevenLabs instrumental bed, loudnorm I=-16. There is NO Higgsfield / Marketing Studio in this format. Creative fields — studio_look.bg, studio_look.lighting_preset, studio_look.rim_light, the <BG>/<LIGHTING> phrases inside beats[].prompt, product_identity.step_1, reveal_variant, beats[2], music.prompt — come from the recipe's choices (backdrop, lighting_mood, reveal, music); never copy them as defaults. Deep teal + luxe_botanical_warm are this demo's picks, not the format's look.",
  "brand_name": "Quillmere Pen Co.",
  "width": 720,
  "height": 1280,
  "fps": 24,
  "duration_s": 15,
  "target_duration_sec": 15,

  "product": {
    "_note": "the REAL product — its geometry is locked by the create-image-fal styled hero built from the real product photo; never AI-invented",
    "name": "Meridian 14 fountain pen (tidewater teal)",
    "category": "writing instrument",
    "form_factor": "four-part fountain pen: screw cap with brass band, steel nib section, piston ink converter, teal resin barrel",
    "hero_png": "assets/product-photos/meridian-14/hero.png",
    "pdp_url": "https://quillmere.example/products/meridian-14"
  },

  "reveal_variant": "exploded_view",
  "_reveal_variant_note": "pick by category: cosmetic bottle/liquid or fragrance -> particle_disintegration; beverage OR a water product (spa/tub/fountain) -> liquid_splash; multi-part / structural product -> exploded_view; large/featureless no-reveal product (a tool, a solid appliance) -> rotation_only (skip Beat 3). The Meridian 14 is a four-part pen -> exploded_view.",

  "studio_look": {
    "bg": "#1F4E5A",
    "_bg_note": "deep teal (the demo brand primary) — the seamless backdrop AND the normalize pad color",
    "lighting_preset": "luxe_botanical_warm",
    "_lighting_note": "the lighting_mood choice. luxe_botanical_warm (warm rim upper-right, soft fill below, warm bokeh) is the demo's pick; others: clean_bright_daylight, dramatic_hard_key, cool_tech_rim — describe the chosen mood in rim_light and in every beat prompt",
    "rim_light": "strong warm rim light from upper-right; soft fill from below",
    "register": "premium product film — glossy speculars, warm bokeh, clean seamless backdrop, no people, no hands, no on-screen text on the plate",
    "reference_videos": "9 catalogued 3D-product-showcase shorts — the format reference"
  },

  "product_identity": {
    "_note": "identity lock — the analog of a character lock. Run BEFORE any i2v clip call. NO Marketing Studio.",
    "step_1": "create-image-fal (fal-ai/nano-banana/edit) — restyle the real product photo onto the seamless brand-color set (centered ~50-55% frame height, warm rim light upper-right, warm bokeh, 9:16, geometry IDENTICAL to the reference, no people/hands/text) -> hero_styled.png",
    "step_2": "host hero_styled.png via MCP file_url (mode upload, PUT, then mode download) so create-video-fal can seed the beats off a PUBLIC url",
    "hard_rule": "the product geometry ALWAYS comes from the real product photo via the create-image-fal restyle — never a text-only AI invention. A lifestyle photo works too; the restyle isolates the product onto the studio set."
  },

  "beats": [
    {
      "id": "beat-01-hero-rotation",
      "label": "Hero rotation — orbiting camera",
      "engine": "fal_i2v",
      "provider": "fal",
      "model": "fal-ai/bytedance/seedance/v1/lite/image-to-video",
      "_model_note": "create-video-fal i2v seeded on hero_styled.png. Seedance Lite is the cheap default; swap to seedance/v1/pro or kling-video/v3/pro/image-to-video for higher fidelity. All are charged to your GooseWorks credits through the GooseWorks proxy.",
      "start_image": "hero_styled.png",
      "duration_sec": 4,
      "_duration_note": "i2v takes are ~5s; build_masters trims to 4s. A single i2v yields a partial arc (~60-120°), NOT a literal 360 — do not promise a full turn.",
      "motion": "A slow deliberate camera orbit around the product; product stays centered horizontally, occupying ~50% of frame height.",
      "prompt": "9:16 PRODUCT-SHOWCASE HERO ROTATION. The Quillmere Meridian 14 — a glossy teal resin fountain pen with a brass cap band and a polished steel nib. A slow deliberate camera orbit around the pen. Pen stays centered horizontally, occupying ~50% of frame height, geometry solid and unchanged. Deep teal seamless backdrop. Strong warm rim light from upper-right; soft fill from below. Subtle warm bokeh in background. Engraved 'quillmere' wordmark on the cap band visible during the orbit. Cinematic, premium craft-object product film. Product identical to the seed hero. No on-screen text.",
      "produces_anchor": "beat1_last_frame.png (ffmpeg -sseof -0.1 -i beat1.mp4 -frames:v 1) — the SHARED seed for Beat 3 AND the Beat 4 hyperframe background",
      "t_start_sec": 0.0,
      "t_end_sec": 4.0
    },
    {
      "id": "beat-02-macro-detail",
      "label": "Macro detail — push-in on the nib",
      "engine": "fal_i2v",
      "provider": "fal",
      "model": "fal-ai/bytedance/seedance/v1/lite/image-to-video",
      "start_image": "hero_styled.png",
      "_start_image_note": "SAME styled hero as Beat 1 so the product reads identical across both beats",
      "duration_sec": 4,
      "motion": "Camera moves smoothly along the barrel to the nib, revealing the engraved scrollwork and the ink slit, with metal detail catching warm rim light; shallow DOF.",
      "prompt": "9:16 MACRO PUSH-IN along the length of the Quillmere Meridian 14 fountain pen. Camera moves smoothly along the barrel to the nib, revealing the engraved scrollwork and the ink slit on the polished steel nib, with metal detail catching warm rim light. Shallow depth of field. Strong specular highlights on the glossy teal resin barrel. Warm bokeh background. Engraved 'quillmere' wordmark visible. Product identical to the seed hero. No on-screen text.",
      "t_start_sec": 4.0,
      "t_end_sec": 8.0
    },
    {
      "id": "beat-03-reveal",
      "label": "Reveal — exploded_view",
      "engine": "veo3_i2v",
      "provider": "fal",
      "model": "fal-ai/veo3/fast/image-to-video",
      "veo3_tier": "fast",
      "start_image": "beat1_last_frame.png",
      "generate_audio": false,
      "duration_sec": 4,
      "_duration_note": "Veo3 fast i2v defaults to an 8s take (no 4s option on the fal-proxy); build_masters trims the best 4s window (rise -> peak -> early settle). Priciest single call in the format.",
      "_reveal_spatial_rule": "the reveal prompt MUST name WHERE the reveal happens (which surface faces the gap) — without it Veo3 tends to pop a part off at random and smear the surface instead of a clean, readable separation. The prompt below shows the spatial clause.",
      "prompt": "The Quillmere Meridian 14 fountain pen separates smoothly along its long horizontal axis into four parts — cap, nib section, ink converter, barrel — sliding apart with even gaps between them. At each gap the threaded joints face each other, brass threads on the left part, resin threads on the right part (like an engineering diagram). A few tiny ink droplets drift through the centre gap. The parts smoothly reassemble. Deep teal seamless backdrop. Camera holds steady, pen stays centered. No on-screen text. No text whatsoever.",
      "t_start_sec": 8.0,
      "t_end_sec": 12.0
    },
    {
      "id": "beat-04-brand-close",
      "label": "Brand close — typographic end card",
      "engine": "html_hyperframe",
      "provider": "playwright",
      "is_end_card": true,
      "method": "build_endcard.py — deterministic Playwright hyperframe (NO AI)",
      "background": "beat1_last_frame.png (stilled)",
      "headline": "FOUR PARTS · ONE PEN",
      "headline_size_px": 92,
      "_headline_size_note": "shrunk from the 110 default because the middot string needs to fit one line at 88% safe area",
      "duration_sec": 3,
      "t_start_sec": 12.0,
      "t_end_sec": 15.0
    }
  ],

  "end_card": {
    "method": "Playwright hyperframe (build_endcard.py, no AI)",
    "background": "beat1_last_frame.png (stilled)",
    "scrim": "linear-gradient(180deg, transparent 38%, rgba(31,78,90,.50) 100%)",
    "headline": {
      "text": "FOUR PARTS · ONE PEN",
      "font": "Playfair Display SemiBold",
      "size_px": 92,
      "uppercase": true,
      "color": "auto",
      "_color_note": "warm-white (#F6F1E7) on dark/saturated bg, dark ink (#2A1F26) on light/pastel bg. The demo's deep-teal bg is dark -> #F6F1E7. build_endcard.py --headline-color to override.",
      "animation": "0.55s spring-rise cubic-bezier(.34,1.56,.64,1), 88% safe area"
    },
    "wordmark": {
      "asset": "quillmere-logo-black.svg",
      "width_px": 180,
      "animation": "0.35s fade-in +0.55s",
      "_note": "the REAL brand wordmark — never retyped, never AI-rendered. build_endcard.py recolors the SVG to the headline color."
    },
    "dwell_sec": 3.0,
    "render_dims": "1080x1920 then ffmpeg scale -> 720x1280 (matching the viewport to the output clips the right edge)"
  },

  "music": {
    "provider": "elevenlabs_music",
    "model_id": "music_v1",
    "prompt": "Minimal ambient-electronic instrumental, soft felt piano over warm analog pads, slow build for 6 seconds, gentle kick + sub-bass drop at 7s carrying through to end. 100 BPM. Premium craft-object film aesthetic. No vocals, atmospheric only.",
    "bpm": 100,
    "music_length_ms": 15000,
    "force_instrumental": true,
    "no_artist_names": true
  },

  "audio_mix": {
    "music_bus": "afade in 0.3s + afade out 0.6s (near the end) + loudnorm I=-16 TP=-1.5 LRA=11, apad + atrim to master duration",
    "master_bus": "loudnorm I=-16 (IG/TikTok safe), -1.5 dBTP true peak",
    "vo": "none — music-only product film"
  },

  "captions": {
    "style": "none",
    "_note": "N/A — music-only, no VO; the only on-screen text is the Beat 4 hyperframe headline (deterministic, not a burned caption)"
  },

  "finalize": {
    "codec": "720x1280 H.264, AAC 192k",
    "normalize": "per beat: trim to window, scale=720:1280:force_original_aspect_ratio=decrease,pad=720:1280:(ow-iw)/2:(oh-ih)/2:color=<bg>,setsar=1 + 24fps + yuv420p + -an (strip the i2v model auto-audio) + crf 18",
    "concat": "ffmpeg concat demuxer over the normalized segments"
  }
}
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