# Ugc Website Video

> 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.

- Skill: `jhamidun/ugc-website-video` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx get-skill add jhamidun/ugc-website-video`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jhamidun/ugc-website-video/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: JHamidun (https://skillmd.com/u/jhamidun)
- Updated: 2026-11-15
- Page: https://skillmd.com/skills/jhamidun/ugc-website-video

---


# 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.

