kevinbadi/ai-os-skills · Archived

youtube-to-viral-posts

Converts YouTube videos into viral Twitter/LinkedIn posts using Gemini AI video analysis.

First seen Apr 8, 2026

Installation

$ npx skills add kevinbadi/ai-os-skills --skill youtube-to-viral-posts

Summary

  • Converts YouTube videos into viral Twitter/LinkedIn posts using Gemini AI video analysis.
  • Generates posts with hooks, stats, step-by-step breakdowns, and CTAs.
  • Trigger when asked to create viral posts from YouTube videos, generate social media posts from video content, or repurpose YouTube videos into text posts.

Stronger alternatives

This repository is archived — consider an actively maintained alternative.

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

Also in this package

Other skills from kevinbadi/ai-os-skills · top by installs.

npx skills add kevinbadi/ai-os-skills

Browse all from kevinbadi/ai-os-skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 55
License MIT
Default branch main
Open issues 0
Status Archived

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,729 B
  • docs SUMMARY.md 344 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 4 installs

SKILL.md

YouTube to Viral Posts

Converts YouTube videos into viral Twitter/LinkedIn posts using Gemini AI video analysis. Downloads the video, uploads to Gemini, and generates a viral post following a proven format.

What It Does

  1. Downloads YouTube video via yt-dlp
  2. Uploads video to Gemini for AI analysis
  3. Generates a viral post following the proven structure: Hook → Body → Steps → CTA
  4. Stores the result in youtubesocialpost database table

How to Run

# Generate viral post from YouTube video
python3 skills/youtube-to-viral-posts/scripts/youtube_to_viral_posts.py "https://www.youtube.com/watch?v=VIDEO_ID"

# With custom CTA keyword
python3 skills/youtube-to-viral-posts/scripts/youtube_to_viral_posts.py "https://www.youtube.com/watch?v=VIDEO_ID" --cta-keyword "AGENT"

Configuration

Environment Variables

GEMINI_API_KEY=xxx
DATABASE_URL=postgresql://...

Dependencies

pip install google-generativeai yt-dlp psycopg2-binary python-dotenv

Post Format (Critical Structure)

1. Hook (Shocking Headline + Stat)

  • Include a believable stat (e.g., "$125,000 generated", "1.6 million views")
  • Reference the AI/tech being discussed
  • Attention-grabbing language

2. Body (Value Proposition)

  • How it works
  • Why it's powerful
  • Impact on business

3. Steps (How-To)

  • Step-by-step breakdown using arrow notation (→)
  • OR "how to copy this workflow/idea"

4. CTA (Call to Action)

  • Comment keyword related to the tech (e.g., "SWAP", "AGENT")
  • Ask them to like the post
  • "Must be following to receive DM"
  • Offer free resource (Loom walkthrough, tutorial)

Output Constraints

  • ✅ Use emojis throughout
  • ✅ Include stat in hook (can be fabricated but realistic)
  • ✅ End with clear CTA (comment keyword)
  • ✅ Output clean text with real newlines
  • ❌ No markdown formatting
  • ❌ No \n as literal text

Important Notes

  • Video Processing: Gemini upload can take 30-60 seconds for longer videos
  • File Cleanup: Temp video files are deleted after processing
  • Rate Limiting: Add delays between multiple video processing requests
  • Database: Uses ON CONFLICT for duplicate URL handling
  • Video Format: yt-dlp downloads as MP4

Scripts

File Purpose
youtubetoviral_posts.py Main viral post generator