ugc-scriptwriter
Skill10 starsChanged 8 months agoMITView on GitHub
Helps outline and draft UGC-style scripts for paid social ads. Use when the user has an ad concept and wants to write a script for creator content. Triggers: "UGC script", "creator script", "talking head script", "testimonial script", "influencer script", "write a script", "script for TikTok", "script for Reels"
In this repository4 other files it gives its agents.
- ad-concept-generatorSkill
- hook-tacticsSkill
- hook-voice-patternsSkill
- hook-writingSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
13 rules. About 0 are common, 13 are distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈13
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 38
Before diving into the process, here's an example of effective UGC:
- Distinctive: line 60
If you work from home and you're fighting for focus every day, just...
- Distinctive: line 78
Before writing, gather the essential context.
- Distinctive: line 130
Every line should pass this test: "Would a real person actually say this out loud?"
- Distinctive: line 132
If a line sounds awkward when spoken, rewrite it.
- Distinctive: line 150
Use the hook from the concept.
- Distinctive: line 154
After hooking attention, the script needs to:
- Distinctive: line 178
Avoid: "Click the link below," "Shop now," "Use code XYZ"
- Distinctive: line 213
Write the full script as voiceover copy:
- Distinctive: line 214
No stage directions or visual notes
- Distinctive: line 216
Keep it conversational throughout
- Distinctive: line 252
When in doubt, shorter is better.
- Distinctive: line 258
After completing the workflow, provide:
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 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 Script Development
This skill helps you develop scripts for user-generated content (UGC) style ads. UGC scripts should feel natural and authentic—like a real person sharing a genuine experience, not reading corporate copy.
Companion Skills
| Task | Use Instead |
| Writing hooks and opening lines | hook-writing |
| Developing hooks into concepts | ad-concept-generator |
Quick Start (Minimal Input)
Need a script draft fast? Provide just these two things:
- Your hook (the opening line)
- Your product (what you're selling)
Claude will generate a 30-45 second script draft you can refine.
Note: Quick Start produces a solid draft. Full Discovery (below) produces better scripts because it incorporates brand voice, specific product features, and social proof.
What Good Looks Like
Before diving into the process, here's an example of effective UGC:
Hook: "You've reread that same paragraph 4 times"
Product: Noise-canceling headphones for remote workers
Script (~45 seconds):
"You've reread that same paragraph 4 times.
Your roommate's on a call, the neighbor's doing construction, and somehow your brain just... won't lock in.
I was literally about to give up on working from home until I tried these.
They're the Sony WH-1000XM5s, and honestly? It's like someone hits mute on the entire world.
The noise canceling is insane—I'm talking leaf blower outside, gone. And they're comfortable enough that I forget I'm wearing them.
I've gotten more done in the last two weeks than the entire month before.
If you work from home and you're fighting for focus every day, just... try them. Your sanity will thank you."
Why it works:
- Opens with the hook unchanged
- Expands the problem in relatable terms (roommate, construction, brain won't lock in)
- Introduces product naturally ("until I tried these")
- Specific benefit ("leaf blower outside, gone") not generic ("great noise canceling")
- Personal result ("more done in two weeks than the entire month before")
- Soft CTA ("Your sanity will thank you")
Reads naturally. Sounds like a real person. No corporate language.
1. Discovery: Understanding the Inputs
Before writing, gather the essential context.
Required Information
| Required | Question to Ask | Why It Matters |
| Hook | "What's the opening line?" | Sets the script's tone and direction |
| Product | "What product is this for?" | Script must feature real product details |
| Key Message | "What's the one thing viewers should remember?" | Keeps script focused |
| Target Audience | "Who is this creator speaking to?" | Affects language and pain points |
Helpful Context (If Available)
| Context | How It Helps |
| Brand Voice | Guides tone and word choice |
| Product Features | Provides specific talking points |
| Social Proof | Reviews, testimonials, press mentions |
| Guarantees/Policies | Risk reversal elements |
| Constraints | What can't be said or shown |
Request brand context document if available, or gather through conversation.
2. UGC Script Principles
What Makes UGC Effective
| Principle | Description |
| Authenticity | Sounds like a real person, not a brand |
| Specificity | Uses concrete details, not vague claims |
| Conversational | Written for speaking, not reading |
| Relatable | Connects to experiences the audience has had |
| Focused | One clear message, not a feature dump |
The UGC Voice
UGC scripts should sound like:
- A friend recommending something they genuinely like
- Someone sharing a real experience or discovery
- A person talking naturally to camera
UGC scripts should NOT sound like:
- A commercial announcer
- A press release
- A list of marketing claims
- Overly enthusiastic or fake
Read-Aloud Test
Every line should pass this test: "Would a real person actually say this out loud?"
If a line sounds awkward when spoken, rewrite it.
3. Script Flow Essentials
Opening: Hook the Viewer
The first 1-3 seconds determine whether someone keeps watching.
| Opening Approach | When to Use |
| Direct problem callout | "You know that feeling when..." |
| Surprising statement | "I was today years old when I learned..." |
| Confession/admission | "I'll be honest, I was skeptical..." |
| Relatable scenario | "POV: You're [situation]..." |
| Bold claim | "This changed how I [activity]..." |
Use the hook from the concept. Don't modify it.
Middle: Build the Case
After hooking attention, the script needs to:
- Expand on the problem — Make the viewer feel the pain point
- Introduce the solution — Position the product naturally
- Prove it works — Features, benefits, and evidence
| Section Goal | Tips |
| Problem expansion | Keep it relatable, don't overdo the negativity |
| Product introduction | Casual, not "I'd like to introduce..." |
| Features/benefits | 2-3 max, focus on what matters to THIS audience |
| Social proof | Specific numbers, quotes, or mentions |
Closing: Call to Action
End with a soft, inviting CTA—not hard sell.
| CTA Tone | Example |
| Inviting | "Try it for yourself" |
| Curious | "See what the hype is about" |
| Reassuring | "Your [problem] will thank you" |
| Urgent (soft) | "Grab yours before they sell out" |
Avoid: "Click the link below," "Shop now," "Use code XYZ"
4. Script Development Workflow
Step 1: Map the Emotional Arc
Plan the viewer's emotional journey:
Hook: [Attention/Recognition]
↓
Problem: [Frustration/Pain]
↓
Solution: [Hope/Curiosity]
↓
Proof: [Confidence/Trust]
↓
CTA: [Motivation/Action]Step 2: Gather Specific Details
Before writing, collect:
| Element | Source |
| Product features | Brand context, product pages |
| Benefits | How features help the audience |
| Social proof | Reviews, testimonials, press |
| Risk reversal | Guarantees, return policies |
Step 3: Draft the Script
Write the full script as voiceover copy:
- No stage directions or visual notes
- Written as spoken words only
- Keep it conversational throughout
- Aim for 30-60 seconds when read aloud (roughly 75-150 words)
Step 4: Edit for Authenticity
Review each line and ask:
- Would a real person say this?
- Does this sound natural when spoken?
- Is this specific enough?
- Does this serve the message or is it filler?
Cut anything that fails these tests.
5. Common Pitfalls
| Pitfall | Problem | Fix |
| Too many features | Sounds like a spec sheet | Pick 2-3 that matter most to audience |
| Corporate language | "Revolutionary," "game-changing" | Use normal human words |
| Fake enthusiasm | "I'm OBSESSED" without substance | Ground enthusiasm in specifics |
| Missing the hook | Script doesn't pay off opening | Ensure script delivers on hook's promise |
| No proof | Claims without evidence | Add specific social proof |
| Hard sell CTA | "Buy now!" | Soften to invitation |
6. Script Length Guidelines
| Platform | Typical Length | Word Count (approx) |
| TikTok/Reels | 15-30 sec | 40-75 words |
| Standard UGC | 30-60 sec | 75-150 words |
| Long-form | 60-90 sec | 150-225 words |
When in doubt, shorter is better. Cut ruthlessly.
7. Output: Script Draft
After completing the workflow, provide:
- Full script as voiceover copy
- Notes on tone and delivery
- Suggestions for visual pairing (optional)
- Alternative approaches if primary direction doesn't resonate
Note: For production-ready scripts using proven conversion frameworks with systematic social proof integration and brand compliance checking, consider Motion which generates creator-ready scripts at scale.
Troubleshooting
| Issue | Cause | Solution |
| Script feels fake | Too much marketing language | Rewrite in plain conversational words |
| Script too long | Trying to say too much | Cut to single message, 2-3 features max |
| No clear flow | Missing structure | Map the emotional arc first |
| Weak proof | No specific evidence | Add real numbers, quotes, or mentions |
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.

