| name | product-commercial |
| description | Direct a polished product film in NodeTool — pack shots, macro hero spots, luxury commercials, brand films on location, with or without talent. Use when the user wants an ad that looks shot on a camera rather than a phone, mentions a pack shot, hero shot, product film, brand spot, cyclorama or studio lighting, or names a product as the subject of a multi-shot video. Not for self-filmed or creator-style pieces (use ugc-video). |
Load /storyboard-core first. It carries the loop, the tool contract,
the entity rules and the gating this skill assumes. Everything below is what is
different about a camera-grade product film.
What makes this job type its own
There is no face to hold steady, so the thing that drifts is the pack: label
geometry, cap, proportions, colour. That is what the product entity is for, and it is
why the reference image matters more here than the descriptor.
The other difference is that a product film's shots are mostly about light, and
light lives in the board style, not in the shot.
Casting the pack
The user's pack shot is the entity. Save the attached image as an asset, then
create_entity {asset_id, kind: "prop", name, descriptor}. Write the descriptor as
geometry and finish — squat 200ml amber glass cylinder, brushed gold screw cap, single centred cream label, serif wordmark — not as marketing copy.
Never invent a logo, a tagline or a label layout. If the label has to be readable, say
so in the shot's action and give that shot a macro framing; if it stays unreadable
after a still, render a new still rather than pushing on to a clip.
Given several angles (front, three-quarter, back, top), tag the best single hero angle
as the entity and keep the rest as plain assets — only the first reference image rides
into the prompt.
The look goes in the board style, once
| Register | style |
|---|
| Luxury studio | black cyclorama, one warm key, gold rim, volumetric mist, 85-100mm, 24fps, no grain |
| Clean e-comm | white sweep, soft top light, even fill, 50mm, no shadow detail loss |
| Location / lifestyle | 90s print / 35mm commercial, hard noon sun, mild bloom, no other brand marks |
| Dark technical | graphite surface, hard side key, specular edges, controlled falloff |
Add no on-screen type to the style. Video models letter badly, and titles belong on
the timeline as text clips (edit_timeline → add_text_clip), where they stay
editable.
Shot pattern
Five to seven shots, and the camera earns each cut. A product film reads as expensive
when the light moves and the pack does not — write that literally:
the light streak crosses the glass, the bottle stays still.
- Put the move in
motion with a distance or a degree: slow 8cm push-in,
low 30-degree orbit, rack focus from cap to liquid.
- Give the last shot a hold:
last 1.2s dead hold — models drift on the tail, and
a hold is what makes an end card usable.
- Count the physical events:
two condensation beads run, one ripple, then still.
- On a location spot with talent, cast the person as a character entity per
/ugc-video's casting pass, but keep the pack's shots free of them with an
explicit entity_ids.
Where a still is the wrong unit
Macro glass, mist and specular highlights are where keyframe mode pays — the still
is cheap and you can judge the light before spending on motion. Keep the default.
Switch a shot to render_mode: "direct" only for heavy motion the first frame would
stiffen: a fast orbit, liquid pouring, an explosive reveal. Then the framing and style
have to go into the action text, since no still carries them in.
Briefs
references/briefs.md has two: a 10s luxury pack shot with no talent, and a 30s
street CPG walk with a character. Replace the bracketed placeholders and hand one over
after the standing orders.
