Skip to content

Latest commit

History

1 Commit

Folders and files

NameName
Last commit message
Last commit date

Repository files navigation

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

ugcscript

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

npm versionLicense: MITZero 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

StyleDescription
relatable-struggleOpens with a pain point the viewer lives
honest-reviewSkeptic-to-believer arc, genuine feel
before-afterTransformation story with specific states
tutorial-drop"3 things nobody tells you" format
duet-baitHook designed for reactions/stitches
hot-takeControversial opinion angle
day-in-my-lifeProduct 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

FlagDescriptionDefault
--count <n>Number of scripts (1-10)3
--style <name>Specific frameworkrandom mix
--platform <p>tiktok, reels, shortstiktok
--jsonJSON outputfalse
--helpShow help
--versionShow 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

Packages

Contributors

Languages