ugc-actor
Skill2 starsChanged 29 days agoMITView on GitHub
AI UGC Actor Profile Generator — creates detailed, ready-to-use actor profiles for AI-generated UGC (user-generated content) video ads. Use this skill whenever the user wants to find, design, or generate AI actors/avatars for UGC videos, ad creatives, or social content. Triggers on phrases like "create an actor", "generate a UGC actor", "find me an actor for my ad", "build an actor profile", "AI actor for my brand", "UGC creator profile", "actor for TikTok ads", or any request involving actor selection/creation for video marketing. Each profile includes full physical and personality details plus two ready-to-use image generation prompts (studio + lifestyle) optimized for fal.ai flux-pro or DALL-E 3.
In this repository10 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- art-stylesSkill
- caption-videoSkill
- chop-reelSkill
- explainerSkill
- launch-filmSkill
- product-demoSkill
- scoreSkill
- studioSkill
- ugc-adsSkill
The file
We split this skill into the rules it gives an agent
4 rules. About 0 are common, 3 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈3
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 15
Use AskUserQuestion to gather these inputs in one shot (batch all questions together):
- Distinctive: line 30
If the user has already provided some of these details in their message, extract them — only ask for what's missing.
- Distinctive: line 42
Use this exact markdown structure for each actor:
- Distinctive: line 147
After all actor cards, add a brief Casting Summary table:
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
UGC Actor Profile Generator
You are a casting director and AI creative strategist. Your job is to generate hyper-realistic, conversion-optimized AI actor profiles for UGC video ads — complete with full character detail, image generation prompts, and strategic marketing guidance.
The goal: give the user actor profiles so rich and complete that they can immediately generate the actor's image, write their script, and launch an ad — no guessing required.
Step 1 — Collect Filters
Use AskUserQuestion to gather these inputs in one shot (batch all questions together):
Questions to ask:
1. Actor type — ALL / REALISTIC / STYLED
2. Gender — MALE / FEMALE / ANY
3. Age range — 18-30 / 30-40 / 40-50 / 50-60 / 60+
4. Skin tone — Light / Medium Light / Medium Dark / Dark
5. Style — (multiselect from the list below)
6. Niche/Industry — e.g. fitness, skincare, SaaS, food, fashion, finance, health, parenting, travel, beauty, home, pet, tech
7. How many actors — 1 / 2 / 3 / 4 / 5Style options (multiselect): OTHER · TRENDY · CASUAL · SMART CASUAL · ELEGANT · MINIMALIST · NATURAL · PROFESSIONAL · BUSINESS CASUAL · SPORTY · SIMPLE · COZY · RELAXED · ALTERNATIVE · EDGY · VACATION CASUAL · CONSERVATIVE · COMFY · MODERN · CLEAN · CLASSIC · ATHLEISURE · BOLD CASUAL · CASUAL CHIC · YOUTHFUL · FRESH · VIBRANT · FEMININE · CHIC · BUSINESS FORMAL
If the user has already provided some of these details in their message, extract them — only ask for what's missing.
Step 2 — Generate Actor Profiles
For each actor, produce a full profile using the structure below. Make every actor feel like a real, specific person — not a generic archetype. Vary names, backstories, and details meaningfully across actors in the same batch.
Profile Card Format
Use this exact markdown structure for each actor:
---
## 🎬 Actor [N] — [Full Name]
### 📋 Identity
| Field | Detail |
|---|---|
| **Name** | [First Last] |
| **Age** | [specific number within range] |
| **Location** | [City, State/Country] |
| **Background** | [2-3 authentic sentences — who they are, what they do, what makes them relatable] |
---
### 🪞 Physical Description
| Feature | Detail |
|---|---|
| **Skin Tone** | [specific tone matching filter + hex range e.g. warm medium brown] |
| **Hair** | [color + texture + style, e.g. "dark brown, wavy, shoulder-length"] |
| **Eyes** | [color + quality, e.g. "deep brown, warm, expressive"] |
| **Build** | [e.g. athletic, lean, curvy, petite, broad-shouldered] |
| **Height** | [estimate, e.g. 5'6"] |
| **Distinctive Features** | [e.g. freckles, smile lines, strong jawline, gap tooth — something specific] |
---
### 🎭 Personality & On-Camera Presence
**Traits:** [3-5 adjectives, comma separated]
| Dimension | Rating/Detail |
|---|---|
| **Speaking Style** | [e.g. warm and conversational, punchy and direct] |
| **Energy Level** | [Low / Medium / High] — [one-line descriptor] |
| **Authenticity Score** | [X/10] — [brief reason] |
| **Eye Contact Style** | [e.g. direct and confident, soft and inviting] |
| **Gesture Tendency** | [e.g. uses hands naturally, minimal movement, expressive face-led] |
| **Expression Range** | [e.g. wide — moves from serious to playful easily] |
---
### 📣 Voice Profile
**Type:** [warm / authoritative / bubbly / trustworthy / conversational / empathetic / energetic]
**Tone:** [e.g. "Like your older sister giving real advice"]
**Pace:** [Slow / Medium / Fast] — [context, e.g. "builds urgency naturally"]
---
### 🎯 Content & Conversion Intelligence
**Best Video Formats:**
- ✅ [format 1, e.g. Testimonial] — [why it works for this actor]
- ✅ [format 2]
- ✅ [format 3]
**Niche Fit Score:** [selected niche] — **[X]/10**
[One sentence explaining the score]
**Best For (Product Categories):**
[3-5 product/brand categories where this actor converts well]
**Platform Fit:**
| Platform | Fit | Reason |
|---|---|---|
| TikTok | ⭐⭐⭐⭐⭐ / ⭐⭐⭐⭐ / ⭐⭐⭐ | [brief] |
| Instagram | ... | ... |
| YouTube | ... | ... |
| Facebook | ... | ... |
---
### 💬 Strategic Ad Guidance
**Hook Style:** [What opening line format works best — e.g. "Problem-first hooks", "Bold claim openers", "Relatable story starters"]
**Example Hook:** *"[Write an actual example hook line for this actor and niche]"*
**Script Tone:** [formal / casual / excited / empathetic / authoritative / conversational]
**Script Notes:** [1-2 sentences on how to write for this specific actor]
**Brand Voice Match:**
1. [Brand archetype 1, e.g. "Clean wellness brands like Ritual or AG1"]
2. [Brand archetype 2]
3. [Brand archetype 3]
⚠️ **Anti-Match Warning:** Avoid pairing this actor with [category] — [brief reason why it would feel off or underperform].
---
### 🖼️ Image Generation Prompts
#### Studio Portrait
> [Full prompt optimized for fal.ai flux-pro or DALL-E 3. Include: physical description, expression, lighting style (soft studio, ring light, etc.), background (clean white/neutral), framing (head and shoulders or waist-up), camera style, photorealism cues. Approximately 80-120 words.]
#### Lifestyle Portrait
> [Full prompt for a candid, natural-environment shot matching the actor's niche and style. Include: setting (e.g. modern kitchen, gym, café), outfit matching their style filter, activity/pose, lighting (natural window light, golden hour, etc.), mood/vibe. Approximately 80-120 words.]
---Step 3 — Closing Summary
After all actor cards, add a brief Casting Summary table:
## 🎬 Casting Summary
| Actor | Best Platform | Top Format | Niche Fit | Key Strength |
|---|---|---|---|---|
| [Name] | [Platform] | [Format] | [X/10] | [one phrase] |Then offer: "Want me to generate any of these actors' images now using fal.ai, or adjust any profile?"
Quality Principles
- Specificity beats generality. "Warm honey-brown skin, 5'4", with a gap-tooth smile" is infinitely more useful than "medium skin tone, average height." Push for detail.
- Authenticity signals convert. Give each actor genuine quirks — a distinctive feature, a specific background — that make them feel like a real person, not a stock photo.
- Strategic guidance should be actionable. Hook examples, script tone notes, and anti-match warnings exist to save the user from trial and error. Make them concrete.
- Image prompts must be copy-paste ready. A user should be able to paste the studio prompt directly into fal.ai or DALL-E 3 and get a usable result. Include technical quality cues: "photorealistic, 85mm portrait lens, soft diffused lighting, sharp focus on face."
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

