ugc-content-factory
npx skills add https://github.com/themattberman/ugc-factory-skill --skill ugc-content-factory
Agent 安装分布
Skill 文档
UGC Content Factory
Generate authentic-feeling UGC content at scale with consistent AI characters.
Use this skill when: You need UGC-style video content (testimonials, reviews, unboxings, demos) without hiring real creators.
The unlock: Kling 3.0’s Elements system (via fal.ai) locks character identity across multiple videos. Combined with multi-shot storyboards and native lip-sync, you can generate an entire UGC library with consistent “creators.”
Director-First Pipeline
Key principle: Visuals before script. Design how each shot looks and moves FIRST, then write dialogue that fits. The script serves the visuals, not the other way around.
MODULE A: Creative Director â Creative Brief â GATE 1 (user approves)
â
MODULE B: Cinematographer â Visual Beat Sheet â GATE 2 (user approves)
â
MODULE C: Screenwriter â Synchronized Script â GATE 3 (user approves)
â
MODULE D: Engineer â fal.ai JSON + Execute â Output
Variable durations: Each shot can be 3s, 4s, or 5s. Hooks are punchy (3s), demos breathe (5s). Total must sum to target duration.
Before You Start: Existing Assets Check
Before entering the pipeline, ASK the user:
- “Do you have an existing character to reuse? (Provide Element image URL)”
- “Do you have product images to use as Elements? (Provide image URL)”
- “Do you have a seed frame / first-frame image? (Provide image URL)”
If yes â use those URLs in the pipeline. If no â new images will be generated with Nano Banana Pro via /ai-image-generation.
Check references/CHARACTER_LIBRARY.md for any previously saved characters/products.
How to Execute
Phase A: Creative Director
Read references/MODULE_A_CREATIVE_DIRECTOR.md before proceeding.
Also load for reference:
references/CHARACTER_LIBRARY.md(character archetypes + saved characters)references/SCENE_SETTINGS.md(setting options)
Tasks:
- Select content format (Testimonial, Unboxing, Problem/Solution, Comparison, Demo)
- Choose hook angle (Gatekeep, Skeptic, Fail, Visual Shock)
- Select character archetype and setting (or reuse saved character)
- Run Stealth Validation (4 mandatory checks)
- Present Creative Brief to user
â GATE 1: Present Creative Brief. STOP. Wait for user approval before proceeding.
Phase B: Cinematographer
Read references/MODULE_B_CINEMATOGRAPHER.md before proceeding.
Tasks:
- Design shot-by-shot visual sequence (NO dialogue)
- Assign variable durations (3s/4s/5s per shot)
- Apply Kling prompt engineering (6 elements, 4 rules)
- Verify scene variety (2-of-4 position/angle changes)
- Generate seed images if using I2V workflow (Nano Banana Pro via
/ai-image-generationâ use Photorealistic Pre-Prompt) - Present Visual Beat Sheet to user
â GATE 2: Present Visual Beat Sheet. STOP. Wait for user approval before proceeding.
Phase C: Screenwriter
Read references/MODULE_C_SCREENWRITER.md before proceeding.
Tasks:
- Calculate word budget per shot (~2.5 words/sec)
- Write dialogue fitted to shot durations
- Apply 4 Audio Rules (sync, cadence, room sound, bridge)
- Map script to Beat Sheet (script-to-beat-sheet template)
- Run script quality check
- Present Synchronized Script to user
â GATE 3: Present Synchronized Script. STOP. Wait for user approval before proceeding.
Phase D: Engineer
Read references/MODULE_D_ENGINEER.md before proceeding.
Tasks:
- Assemble Visual Beat Sheet + Script into
multi_promptJSON - Run compilation checklist
- Submit to fal.ai (standard for test, pro for final)
- Use queue endpoint for anything over 5 seconds
- Present output with quality check
Character Setup (One-Time)
Before first video with a new character:
- Define persona brief (see CHARACTER_LIBRARY.md)
- Generate 3-5 reference images via Nano Banana Pro (
/ai-image-generation) â use Photorealistic Pre-Prompt from MODULE_B - Select best reference image(s)
- Upload to fal.ai Kling 3.0 Elements
- Save character to CHARACTER_LIBRARY.md “Saved Characters” section for reuse
Integration with Other Skills
| Skill | Use For |
|---|---|
/ai-image-generation |
Character reference images via Nano Banana |
/ai-talking-head |
Fallback for single-shot videos |
/hooks |
Generate hook variations for A/B testing |
/direct-response-copy |
Script optimization for conversion |
/brand-voice |
Ensure scripts match client voice |
The 80/20
80% of UGC success comes from:
- Right character for target audience
- Specific, genuine-sounding script (not marketing speak)
- Appropriate casual setting (not studio)
- Strong hook in first 2 seconds
Get these right and the rest is optimization.
Quick Tips
Do:
- Lead with imperfection â slightly off framing, natural pauses, filler words
- Use specific details â “3 weeks” not “a while”
- Match character to audience demographic
- Keep it short â 15-30 seconds, not 60+
Don’t:
- Over-polish â if it looks like an ad, it fails
- Use marketing language â “revolutionary” = instant scroll-past
- Skip the visual design phase â visuals drive everything
- Fight the shot durations â adapt the script to the visuals
Module Reference Files
All detailed instructions are in references/:
| File | Content | Lines |
|---|---|---|
MODULE_A_CREATIVE_DIRECTOR.md |
Formats, hooks, stealth validation, creative brief | ~250 |
MODULE_B_CINEMATOGRAPHER.md |
Visual design, Kling prompting, beat sheet | ~300 |
MODULE_C_SCREENWRITER.md |
Audio rules, sync, script templates, mapping | ~250 |
MODULE_D_ENGINEER.md |
API reference, JSON assembly, queue management | ~200 |
CHARACTER_LIBRARY.md |
Archetypes, design process | ~100 |
SCENE_SETTINGS.md |
Setting tables and selection rules | ~50 |