skills/ugc-website-video/SKILL.md

---
name: ugc-website-video
description: >
  Produce a finished creator-led UGC video about a website, web app, online service,
  store, or product page, using real captured screenshots while a talking-head
  creator narrates. Use for SaaS UGC, site tours, app tours, or requests where
  the supplied page must appear. Do not load this skill for text-only scripts,
  outlines, or walkthrough plans, even if they mention UGC or SaaS; do not use
  it merely as a scriptwriting reference. Missing URL or duration is an intake gap. Do
  not use for product-only ads, unboxings, tutorials, try-ons, website editing,
  generated UI, scripts, or footage edits.
---

## Activation analytics

When using this skill for a new user request, call `track_skill_activation` once with `{"skill_name":"ugc-website-video"}` at the earliest opportunity that preserves widget-first and exclusive-tool turns; defer to a later turn when required. Do not repeat for polling, retries, references, or continuation of the same request. If tracking is unavailable or fails, continue the task without retrying. Send only the skill name.

# UGC website video

Produce one hosted 9:16 MP4. A single talking-head creator remains on camera and
speaks continuously. Real mobile screenshots from the supplied URL appear as
large static overlay cards. There are no storyboards and no generated UI.

## Runtime contract

- Use only tools exposed by the current OpenAI host and Higgsfield MCP.
- Ask with `ask_user_input` when exposed, `ask_user_input_v3` only when that
  exact variant exists, otherwise one concise normal-chat question. Never use
  legacy elicitation names.
- Import ChatGPT creator photos or user screenshots once through
  `media_upload_and_confirm` and keep their confirmed IDs and URLs.
- Run browser capture, ffmpeg, Python, downloads, probing, transcription,
  compositing, and uploads only through `sandbox_exec`.
- The sandbox is ephemeral. Reserve every output that must survive with
  `media_upload` before the command, PUT it from the same command, then call
  `media_confirm` after HTTP 200.
- Capture and caption scripts are preinstalled at
  `$HF_WORKFLOWS/ugc-website-video/scripts/`.
- Use `generate_image_batch` and `generate_video_batch`, stable
  `{index, params}` entries, `params.count:1`, and at most six requests per call.
- Wait through `jobs_wait` in groups of at most eight and
  `timeout_seconds:15`. Poll only active or retryable lookup-failed jobs.
- Never pass an entry without `job_id` to `jobs_wait`; retry only rejected or
  failed indices.
- For `unlim_choice`, ask its message and resubmit unchanged with the user's
  `use_unlim` choice.
- Never substitute a different model for a locked unavailable model.

## Hard rules

- Screen content is always real captured pixels from the supplied site or
  screenshots the user supplied. Never generate, restyle, animate, or invent UI.
- Never ask the user to record their screen. Never use web search or an
  unrelated source to fill missing page content.
- Creator stays on camera and supplies the continuous audio spine. Screenshot
  cards overlay the creator; they are never full-screen or scrolling.
- Body clips are visually product-free. A physical product may appear only in
  the closer and only from a real image on the supplied page.
- Use the same `character_media_id` in every clip and never regenerate it.
- Captions are on by default. Only an explicit “no captions” request skips them.
- Capture failure on the first attempt triggers one user choice immediately:
  send screenshots or make a talking-head-only version. Do not silently retry.
- Hide models, job IDs, internal phases, and intermediate files.

## Duration

| Total duration | Clips | Clip durations |
| --- | ---: | --- |
| 4–15s | 1 | total duration |
| 16–19s | 2 | balance both to at least 4s |
| 20–30s | 2 | 15, remainder |
| 31–45s | 3 | 15, 15, remainder |
| 46–60s | 4 | 15, 15, 15, remainder |
| >60s | ceil(D/15) | 15 each, final clip at least 4s |

## Phase 0 — Intake and routing

Parse required URL, duration, attached creator photo or desired gender,
appearance/location overrides, site type/audience/surface, language, approved
claims, and `caption_mode`: `Both` default, `Subtitles`, or `Hook`.

Stay in this skill when the user names SaaS UGC/site tour or wants the supplied
page visible. A product-page URL stays here when its page appears onscreen.
Hand off to product-side UGC only when the page will not appear.

Ask once for missing URL, duration (offer 10s/15s/30s/45s), creator input, and
caption mode when unspecified. Do not offer generated UI, scrolling, full-screen
screens, model choices, aspect ratios, audio choices, or clip-count forks.

## Phase 1 — Capture the site

Read `references/website-capture.md`. Reserve image upload slots before capture.
Run the preinstalled mobile Chromium capture in one self-contained
`sandbox_exec`, producing and uploading:

- one full-page mobile capture for the section map;
- 6–10 useful dedicated stills when available: hero/product, features,
  dashboard/search/editor, reviews, specs, pricing, or plans.

Confirm successful uploads and keep their hosted URLs. Skip nav/footer/logo
filler. Build an ordered section map; the same order drives monologue beats and
overlay cards.

On error, bot wall, login gate, blank result, or fewer than three usable cards,
ask immediately: `I'll send screenshots` or `Make it without the site`. If real
screenshots do not arrive, continue talking-head-only and disclose that in the
final report.

## Phase 2 — Lock the creator

If the user attached a creator photo, import it and use it unchanged. Skip the
generated-seed de-slop pass.

Otherwise read `references/ugc-character.md` and
`references/saas-ugc-character.md`, settle fresh variety rolls, write a clean
product-free creator prompt, and submit:

```json
{"requests":[{"index":0,"params":{"model":"soul_2","prompt":"<creator prompt>","count":1,"aspect_ratio":"3:4","quality":"2k"}}]}
```

Wait until terminal, then take the completed creator `result_url` returned by
`jobs_wait` and de-slop the generated seed with one `generate_image_batch`
request: `seedream_v5_pro`, that HTTPS result URL with canonical role `image`,
3:4, 2k, and this exact prompt:

> KEEP EXACTLY the framing, composition, pose, subject and identity of this
> vertical portrait — no reframe, no zoom, no crop, no change to the person's
> face / hair / body / clothing. CHANGE ONLY micro-realism: true-to-life
> pore-level skin with natural texture and fine vellus hair, real material
> detail, even natural daytime light with gentle highlight roll-off and faint
> true sensor noise, a flat authentic iPhone selfie, deep focus. PRESERVE the
> face's exact shape / width / proportions 1:1 — do NOT squeeze / narrow / slim /
> stretch the face. AVOID AI-slop: waxy plastic skin, airbrushed poreless skin,
> beauty-filter smoothing, over-saturation, HDR glow / bloom / halos,
> oversharpening, teal-orange grade, shallow depth of field, bokeh, cinematic /
> DSLR look. No added text, no watermark.

The OpenAI generation route imports that URL as a concrete `media_input` and
normalizes the generic image role to Seedream's `image_references` wire field.
Never pass the raw creator job ID to this i2i call.

On moderation failure retry once with `seedream_v5_lite`; then keep the raw
creator. Lock the final creator ID for every clip.

## Phase 3 — Write monologue and card plan

Read `references/saas-monologue.md`. Write in English unless explicitly changed.
Use hook → site solves it → result/action. The first body beat names the site;
later body beats follow captured card order; the closer contains no card.

Target 22–26 words for ≤10s, 28–33 for 11–12s, and 35–40 for 13–15s, with
varied 2.4–2.7 words/second delivery. Save exact `output/script.txt`, a ≤6-word
`output/hook.txt`, and ordered `{section_label, words}` beats.

## Phase 4 — Generate talking-head clips

Read `references/saas-clip-prompt.md`. Write every clip prompt before submission.
Each is one continuous shot: no board, slot, cut, site/UI visual, or product in
body clips. Restate locked identity, medium 9:16 framing, centered head, US
accent, varied lively pace, phone-mic audio, matching ambience, and no music.

For a physical-product closer, extract one real product image only from the
supplied page, convert it to a confirmed Higgsfield image UUID, and add it as the
second media. If no usable product image exists, use a neutral closer gesture.

Submit all N requests through `generate_video_batch`, at most six per call:

```json
{"requests":[{"index":1,"params":{"model":"seedance_2_5","prompt":"<one-shot prompt>","count":1,"aspect_ratio":"9:16","resolution":"1080p","duration":15,"mode":"omni_reference","generate_audio":true,"medias":[{"value":"<character_media_id>","role":"image"}]}}]}
```

The physical closer adds `product_closer_reference` with role `image`. If that
closer is moderated, retry only it without product media, with the same creator.
Never regenerate the creator.

Before submission reject any body prompt containing `Hard cut`, `Cut 1`,
`slot`, `board`, a product visual, or a rendered website/UI/screen/browser.

## Phase 5 — Frozen-frame QA

Inspect each accepted clip at evenly spaced and 2–3 mid-word frames. Require one
creator, at most two hands, stable identity, clean lips, no generated UI, no
body product, and no baked text. Fix and rerun only the failed clip.

## Phase 6 — Composite

Read `references/screen-broll-and-composite.md`. Reserve the final video upload,
then run one self-contained sandbox command that downloads clips and confirmed
card images, concatenates clips in stable order, and overlays cards at authored
word-time anchors:

- no card during first ~1–2s hook or closer;
- each card ~1.2–1.5s with ~0.3–0.5s clean-face gap;
- contain-fit inside ~0.78W × ≤0.60H, centered and shifted slightly up;
- keep the bottom ~15% clear for captions;
- copy audio and encode video once.

With no site cards, concatenate the talking-head clips only. The phase is not
complete until `output/final.mp4` exists and was PUT successfully.

## Phase 7 — Captions

Read `references/subtitles.md`. Captions are on by default. Use word-level
Whisper timing from final audio and burn the selected `Both`, `Subtitles`, or
`Hook` layers in one pass. Never infer timings. If no speech is found, burn
nothing and deliver the clean final. PUT and confirm the chosen final video.

## Phase 8 — Deliver and optionally publish

Return one confirmed hosted video URL and duration. State when site capture was
unavailable and the output is talking-head-only.

Then ask once whether to publish to TikTok. On yes, use the current sequence:
`tiktok_accounts` → `tiktok_connect` if needed → `tiktok_prepare_publish` →
only after the user's explicit confirmation, `tiktok_publish` →
`tiktok_publish_status`. Never publish without explicit approval.

## References

- `references/website-capture.md`: real-page capture and failure gate
- `references/ugc-character.md`: creator prompt
- `references/saas-ugc-character.md`: SaaS casting and clip carry
- `references/saas-monologue.md`: spoken arc and card ordering
- `references/saas-clip-prompt.md`: continuous talking-head prompt
- `references/screen-broll-and-composite.md`: screenshot overlay recipe
- `references/subtitles.md`: default caption burn

Never load sibling product-side UGC references.