ugc-scriptwriter
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"
What this skill does
# 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:
1. **Your hook** (the opening line)
2. **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:
1. **Expand on the problem** — Make the viewer feel the pain point
2. **Introduce the solution** — Position the product naturally
3. **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](https://www.motionapp.com) which generates creator-readyRelated in Ads & Marketing
ads
IncludedMulti-platform paid advertising audit and optimization skill. Analyzes Google, Meta, YouTube, LinkedIn, TikTok, Microsoft, and Apple Ads. 250+ checks with scoring, parallel agents, industry templates, and AI creative generation.
banana
IncludedAI image generation Creative Director powered by Google Gemini Nano Banana models. Use this skill for ANY request involving image creation, editing, visual asset production, or creative direction. Triggers on: generate an image, create a photo, edit this picture, design a logo, make a banner, visual for my anything, and all /banana commands. Handles text-to-image, image editing, multi-turn creative sessions, batch workflows, and brand presets.
rpg-migration-analyzer
IncludedAnalyzes legacy RPG (Report Program Generator) programs from AS/400 and IBM i systems for migration to modern Java applications. Extracts business logic from RPG III/IV/ILE source code, identifies data structures (D-specs), file operations (F-specs), program dependencies (CALLB/CALLP), and converts RPG constructs to Java equivalents. Generates migration reports, complexity estimates, and Java implementation strategies with POJO classes, JPA entities, and service methods. Use when modernizing AS/400 or IBM i legacy systems, analyzing RPG source files (.rpg, .rpgle, .RPGLE), converting RPG to Java, mapping data specifications to Java classes, planning legacy system migration, or when user mentions RPG analysis, Report Program Generator, RPG III/IV/ILE, AS/400 modernization, IBM i migration, packed decimal conversion, or mainframe application rewrite.
brand-library-architect
IncludedBuild a complete brand library for a product — visual asset render pipeline, brand documentation set (BRAND, COPY, MANIFESTO, BIOS, FAQ, GLOSSARY, TONE, PRICING), open-source convention files (README, CONTRIBUTING, SECURITY, CODE_OF_CONDUCT), and a self-contained press kit. This skill should be used when the user asks to "build a brand library / brand kit / press kit / brand assets" for a product, "set up a brand library workflow," "create a positioning manifesto plus visual identity," or any combination of brand documentation + visual asset pipeline. Apply phase-by-phase or run end-to-end. Templates are product-agnostic and use {{TOKEN}} placeholders the skill prompts the user to fill.
writing-tech-post
IncludedAuthors engineering blog posts end-to-end: launch deep-dives, incident postmortems, architecture migrations, performance case studies, tutorials, AI/agent system writeups, security disclosures, and research-to-product translations. Picks the correct archetype, plans the abstraction ladder, enforces an evidence cadence (diagrams, benchmarks, profiles, traces, code, ablations), tunes voice against publisher house styles (Datadog, Vercel, GitHub, AWS, Meta, Cloudflare, Jane Street), and runs a pre-publish gate for narrative momentum and disclosure ethics. Use when drafting a new engineering post, restructuring a draft that feels flat, deciding which evidence form belongs where, validating that depth and product context are balanced, or preparing a postmortem, migration, or performance narrative for external publication. Do not use for API reference documentation, README authoring, marketing copy, release notes, generic SEO content, ghost-written executive thought leadership, or non-engineering long-form essays.
blog-google
IncludedGoogle API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity analysis for E-E-A-T, YouTube video search for embedding, and Google Ads Keyword Planner. Progressive feature availability based on credential tier (API key, OAuth/service account, GA4, Ads). Shares config with claude-seo at ~/.config/claude-seo/google-api.json. Use when user says "google data", "page speed", "core web vitals", "search console", "indexation", "GA4", "keyword research", "nlp entities", "blog performance", "youtube search", "google api setup".