ugc-scripts

UGC Script Writer

Create authentic creator-style scripts for paid social ads. The core test: would a real person actually say this out loud?

Scripts are talking points with a scripted hook — not teleprompter copy. The creator should rephrase everything in their own words except the opening line.

---

Phase 1: Discovery

1a. Parse Arguments

• Hook or concept ($ARGUMENTS): The opening line, concept direction, or product angle. Can be a specific hook from /write-hooks or a general direction.
• Product: What's being sold. If not in args, ask.
• --creator-type: micro-influencer, customer-testimonial, expert, founder, or any. Default: any.
• --duration: Target length. Default: 30s (75-100 words). Options: 15s, 30s, 45s, 60s.

If hook and product aren't provided, ask before proceeding.

1b. Load Context

1. Read ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md for brand voice, creative do's/don'ts, target demographics, production constraints. If the file does not exist, use these defaults and suggest the user run /customize:
   • default_date_preset: LAST_30_DAYS
   • Brand guidelines: pull from get_workspace_brand
   • production_capabilities: all formats
2. Read ${CLAUDE_SKILL_DIR}/../creative-strategist/SKILL.md for methodology.
3. Read ${CLAUDE_SKILL_DIR}/../creative-strategist/references/brief-template.md for output structure reference.
4. Use default_date_preset from settings as the datePreset for all calls unless the user specified a date range.

1c. Pull Performance Data

The SPEND call must come first (it returns goalMetric and spendThreshold). Then dispatch remaining calls in parallel.

1. get_auth_context() — resolve workspace
2. get_creative_insights(workspaceId, insightType="SPEND", datePreset="LAST_30_DAYS", limit=10, withAggregatedInsights=true) — spend leaders + account-level aggregates

→ Extract goalMetric and spendThreshold from the response. Use goalMetric for all efficiency-sorted calls.