/generating-ugc-videos

name: generating-ugc-videos
description: Generates a UGC video — a creator or customer, on camera as themselves, sharing their own authentic take on a product. Use when the user wants a UGC video, creator video, influencer ad or endorsement, tiktok-style review, unboxing, try-on, OOTD, fit check, haul, tutorial, talking head, or creator testimonial. Not for a produced advertisement in the brand's voice, where a presenter or actor plays a role in the brand's spot — that is generating-ad-videos; not for a video with no person in it, or a person with no product to show.
license: Apache-2.0
metadata:
  version: "0.9.0"
  category: creative
  summary: "Produces UGC videos of any length - like review, unboxing, try-on, tutorial and more. It casts the actor, writes the script, and storyboards multiple clips to lock in actor and product consistency. It lets you direct every step to get a cohesive, ready-to-run ad in minutes."

UGC Video

Turn a product into a video of a creator on camera.

Videos that do not have a person on camera with a product are out of scope — those should be generated by the `generating-videos` skill. A produced advertisement in the brand's voice — a commercial, TV ad or brand film where the person plays a role in the brand's spot rather than a creator sharing their own take — belongs to `generating-ad-videos`, even when a presenter is on camera.

**Settled for every job — never ask about these, and never re-decide them:** the delivered video is `9:16` unless the user explicitly asked for `16:9` · the clip model is `seedance-2.0-fast` with audio on, unless the user named one · storyboard sheets are `gpt-image-2` at `16:9` · how many clips there are comes from the length · the clips are always joined, hard cuts, no transitions.

Workflow

Step 1: Read what you have

• **A product image or URL** → hand it to `analyzing-products` for what the product is, how a person

physically uses it, which parts open or move, and what must stay identical wherever it appears.

• **Run `image_analysis` on every image supplied**, not only the product — what each one shows, and

whatever the product facts leave out.

• **What each image is for comes from the brief, not from its contents.** A person in a frame does

not make it a casting photo, and a second object does not make it a prop.

• **No product** → don't guess at one. It becomes the first thing Step 2 asks for.

Step 2: Interview

**Skip this when the brief already settles the video** — a clear product, a clear format, a length.

Otherwise ask once, bundled into a single message, always with a free-text way out.

| Ask | When | | --- | --- | | **The product** — a link or a photo | Neither was supplied. Offer to wait for an upload; a photographed product beats a described one. | | **How long** | The brief doesn't say. Offer 15s, 30s, 45s or 60s, and let them type their own. | | **Whether the person in a supplied photo should be the creator** | An image with a person in it was supplied and the brief doesn't say who they are. Ask rather than assume either way. | | **Whether they have a photo of the delivery package** | The brief is about opening a package and none is attached. If they have one, **wait for it to arrive** before building anything — a promised photo is not a photo. If they don't, a plain unbranded box stands in. |

When the user waives questions, take 15s, say in one sentence what you took, and keep going.

Step 3: Select the mode and read the corresponding reference file

| The ask is about… | Mode | Reference | | --- | --- | --- | | Holding the product and talking about it | **review** | `references/mode-review.md` | | Opening the package it arrived in | **unboxing** | `references/mode-unboxing.md` | | Wearing it — clothing, shoes, jewellery, accessories | **try-on** | `references/mode-try-on.md` | | Showing how to use it, one step at a time | **tutorial** | `references/mode-tutorial.md` |

**Where two rows both fit, these win:**

• **A sealed package is opened on camera** → **unboxing**.
• **The product ends up worn** → **try-on**, even when a bag is opened to reach it.
• **Numbered steps, or "how do I use this"** → **tutorial**, whatever the tone.
• **Nothing to open, wear or work through** → **review**.

Step 4: Write the product description

Write one description and reuse it unchanged in every storyboard — rephrasing it between calls reads as a different product.

• **Material and finish**, surface by surface — matte or gloss, brushed, woven, translucent, or

whatever this one actually is: *"brushed steel barrel, matte soft-touch collar, a woven wrist strap"*.

• **Size** — its width and height, and how it sits against a hand: *"sits in a closed palm, roughly

9 cm tall and 4 cm across"*. Give the real measurements rather than likening it to another object, which the model renders inconsistently.

• **Two to five visual anchors** — features you can verify in the product image and nothing else:

exact colours, the shape of a closure or handle, the gauge of a chain or strap, a surface finish, a distinguishing mark.

• **The product mechanism** — how it's built and how it works: the parts that move, how they open or

close, and where anything dispenses: *"hinged lid at one end, folds back flat; the brush sits inside the cap"*.

• **What may be done with each part** — which parts are fixed to it, and the whole of what the moving

ones allow. Nothing later does anything to the product that isn't on this list.

**Don't transcribe what the label says**, even where the product facts spell it out. Spelling out the printing invites the model to redraw it, and redrawn text comes back warped. The facts may name it; the description never repeats it.

Step 5: Write the concept

**What the user asked for wins.** Wherever the brief is specific — a scenario, a shot list, a named place, a line they want said, a mood — follow it exactly and keep following it for the rest of the job. Everythin