Skip to content

SlashImagine/ugcscript

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

                              _       _   
  _   _  __ _  ___ ___  ___ _ __ (_)_ __ | |_ 
 | | | |/ _` |/ __/ __|/ __| '__| | '_ \| __|
 | |_| | (_| | (__\__ \ (__| |  | | |_) | |_ 
  \__,_|\__, |\___|___/\___|_|  |_| .__/ \__|
        |___/                     |_|        

ugcscript

Generate UGC video scripts for TikTok, Reels & Shorts. Instantly.

npm version License: MIT Zero Dependencies

Zero API keys. Zero cringe. Just scroll-stopping scripts.


⚡ Quick Start

npx ugcscript "protein powder for busy moms"

That's it. 3 UGC scripts in your terminal. No signup, no API keys, no waiting.


📦 Install (optional)

npm install -g ugcscript

Or just use npx — no install required.


🎬 Usage

# Generate 3 scripts (default)
npx ugcscript "AI writing tool for freelance copywriters"

# Generate 5 scripts
npx ugcscript "standing desk converter" --count 5

# Use a specific framework
npx ugcscript "dog anxiety supplement" --style honest-review

# Target a specific platform
npx ugcscript "meal prep containers" --platform reels

# Output as JSON (for pipelines)
npx ugcscript "skincare serum" --json

# Show help
npx ugcscript --help

🎯 Script Frameworks

Style Description
relatable-struggle Opens with a pain point the viewer lives
honest-review Skeptic-to-believer arc, genuine feel
before-after Transformation story with specific states
tutorial-drop "3 things nobody tells you" format
duet-bait Hook designed for reactions/stitches
hot-take Controversial opinion angle
day-in-my-life Product woven into daily routine
skeptic-convert "I made fun of this. Then I tried it."

📋 Output Structure

Every script includes:

  • HOOK — 1-2 lines to stop the scroll (first 3 seconds)
  • BODY — 3-4 beats of content (~20-40 seconds spoken)
  • CTA — Clear call-to-action with specific verb
  • CAPTION — Suggested post caption + 3 hashtags

💻 Example Output

  ⚡ ugcscript v1.0.0
  3 UGC scripts for: protein powder for busy moms

╭─────────────────── Relatable Struggle ───────────────────╮
│ #1 • TIKTOK • ~78 words                                  │
│                                                          │
│ HOOK:                                                    │
│ POV: You've tried literally everything for your fitness  │
│ routine and nothing sticks.                              │
│                                                          │
│ BODY:                                                    │
│ → I've been that person — scrolling at 2am looking for   │
│   answers, buying everything influencers recommend.      │
│ → Then someone mentioned protein powder for busy moms    │
│   and honestly? I almost scrolled past it.               │
│ → But I tried it anyway because what did I have to lose. │
│ → Two weeks in and I literally cannot shut up about it.  │
│                                                          │
│ CTA:                                                     │
│ Link in bio if you're tired of wasting money on stuff    │
│ that doesn't work.                                       │
│                                                          │
│ CAPTION:                                                 │
│ the one that finally worked 😭✨                          │
│ #fitness #fitnessfindsoftiktok #gamechanger              │
╰──────────────────────────────────────────────────────────╯

🤔 Who is this for?

  • UGC creators who need script ideas fast
  • DTC brand marketers creating ad content
  • Social media managers batching content
  • Ad agencies brainstorming angles
  • Freelance copywriters pitching script concepts
  • Anyone who needs to make short-form video content and hates staring at a blank page

🛠 Options

Flag Description Default
--count <n> Number of scripts (1-10) 3
--style <name> Specific framework random mix
--platform <p> tiktok, reels, shorts tiktok
--json JSON output false
--help Show help
--version Show version

🏗 Technical Details

  • Pure Node.js — zero npm dependencies
  • ANSI terminal colors — beautiful output, no chalk needed
  • Works with npx — no global install required
  • Node 14+ compatible
  • ~30KB total — downloads in milliseconds

🤝 Contributing

PRs welcome! Ideas for new frameworks, better hooks, or improved templates — open an issue or submit a PR.

git clone https://github.com/slashimagine/ugcscript.git
cd ugcscript
node bin/ugcscript.js "test product"

📜 License

MIT © SlashImagine


Part of the /IMAGINE open-source toolkit
Tools for creators who ship.

About

Generate UGC video scripts for TikTok, Reels & Shorts. Zero API keys. Zero fluff.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors