---
name: ugc-generator
description: >
  Create authentic UGC-style videos with Unsora — selfie clips, product spots,
  talking-head ads, and AI influencer content. Use when the user wants UGC,
  creator-style ads, on-camera product demos, or short social spots via Unsora.
---

# UGC Generator

Generate creator-style UGC through Unsora's MCP tools (`create_video`, influencer
studio / avatar flows). Optimized for TikTok, Reels, and Shorts.

---

## Prerequisites

- Unsora MCP connected (OAuth via Claude plugin or API key)
- Sufficient credits (`get_credits`)
- Optional: product stills or face references as public HTTPS URLs

---

## Workflow

1. **Clarify the brief** — product, hook, who is on camera, platform (`9:16` default)
2. **Pick the format** — selfie UGC, talking head, unboxing, demo, testimonial
3. **Gather references** — product image URLs and/or recurring AI face if available
4. **Check credits** — `get_credits`
5. **Generate** — call `create_video` (Seedance 2.0) with:
   - `prompt` — shot type, subject, action, environment, camera, lighting, dialogue
   - `ratio` — default `9:16`
   - `duration` — 4–15 seconds
   - `image_files` when conditioning on product or face stills
6. **Preview hosts (Claude.ai)** — live preview polls automatically; do not call `wait_for_video`
7. **Other hosts** — `wait_for_video` with `generationId` until `COMPLETED`

---

## Prompt recipe (UGC)

Layer the prompt:

1. **Shot type** — selfie UGC, handheld talking head, kitchen demo
2. **Subject + action** — who holds the product and what they do
3. **Environment** — bedroom, kitchen, car, bathroom vanity
4. **Camera** — casual iPhone handheld, slight shake, eye-level
5. **Lighting** — natural window light, soft ring light, golden hour
6. **Dialogue** — one short authentic line (keep concise for short clips)

**Example:** *"9:16 selfie-style clip, woman in bright kitchen holding skincare bottle, casual iPhone handheld, natural window light, she glances at camera and says the product replaced her old routine, authentic not polished."*

---

## After delivery

Offer: alternate hook, different face, longer cut (within 15s), companion thumbnail
(`create-thumbnail`), or schedule to TikTok/Instagram (`schedule-post`).

---

## Errors

- **Insufficient credits** — show balance, suggest top-up at app.tryunsora.com/billing
- **FAILED status** — simplify prompt or reduce references, retry once
