# UGC Video

UGC Video (ugc-video) is a Claude Code skill that makes UGC-style video ads for Instagram Reels, TikTok and Shorts: an AI avatar talks to camera from the corner while real screen recordings of your product play behind it.

Skill · By Lior · Works with Claude Code · Updated 2026-10-21 · v0.1.0

## Install

```sh
npx skills add lior-pesoa/skills --skill ugc-video
```

Source code: https://github.com/lior-pesoa/skills/tree/main/skills/ugc-video

## What it does

- Writes a 4-line script, one line per avatar clip, and 3 hooks of different types to test, each line matched to the screen behind it.
- Writes the avatar's background story, a ready-to-paste prompt per clip, the settings, and a plan to keep the voice the same across clips.
- Transcribes every generated clip and flags words the model added or dropped, plus pauses and framing differences.
- Joins the clips into one fast cut, removes the background so the avatar stands in the corner, and renders 1080×1920 with HyperFrames.
- Writes the posting notes: caption, timed lines for native captions, AI disclosure, music, cover and an ad link with UTM tags.

## When to use it

Use it when you want a short ad that reads like a creator's tip, you have screen recordings of your product, and you'd rather not film yourself. I built it from the Top Banana ad for wedding caterers.

## Example

You ask: /ugc-video src/clip1.mp4 src/clip2.mp4 src/clip3.mp4 src/clip4.mp4

It returns:

- [x] Clip 4: invented words ("check bow tip with a friend"), cut in the edit
- [x] Clips 2 to 4 framed wider than clip 1, cropped to match
- [x] 34.3 s raw → 23.6 s after pauses cut and 1.12x speed, -16 LUFS
- [x] Rendered 1080×1920, transcript matches the script word for word
- [ ] Waiting on you: add captions in Instagram Edits and post

## How it works

1. Reads your project for the product, the audience, the screen recordings and the brand rules.
2. Writes the script and hooks under honesty rules: no fake testimonials, no invented numbers.
3. Gives you the avatar character, prompts and settings to paste into your video tool.
4. Checks the clips you bring back by transcript, then edits, removes the background and renders.
5. Transcribes the render to check it against the script, then writes the posting notes.

## Questions

### Does it make the avatar clips?

No. You make them in your own AI avatar tool. The skill writes the character, prompts and settings, and checks the clips you bring back. Its steps are written from OpenArt and map to HeyGen, Hedra, Kling and similar tools.

### What do I need installed?

ffmpeg, whisper.cpp with an English model, Node 18 or later for `npx hyperframes`, and Python 3. Rendering, transcription and background removal run on your machine.

### Will the avatar pretend to be a customer?

No. The avatar never claims to use your product or to have results, says no made-up numbers, and the posting notes include an AI disclosure.

### Does it post the video?

No. It stops at a finished render and a posting notes file. You post it.

## Related

- [How I make AI UGC ads with Claude Code](https://www.liorpesoa.com/library/ai-ugc-ads-with-claude-code.md)

---

Page: https://www.liorpesoa.com/library/ugc-video
Library: https://www.liorpesoa.com/library