kevinbadi/ai-os-skills · Archived

youtube-to-heygen-longform

Converts YouTube videos into long-form (10-14 minute) landscape avatar videos using HeyGen AI clone.

First seen Apr 8, 2026

Installation

$ npx skills add kevinbadi/ai-os-skills --skill youtube-to-heygen-longform

Summary

  • Converts YouTube videos into long-form (10-14 minute) landscape avatar videos using HeyGen AI clone.
  • Analyzes video with Gemini, generates full Alex Hormozi-style script condensed to max 2000 words, creates 1920x1080 landscape avatar video.
  • Trigger when asked to create long-form avatar videos, clone long YouTube videos, or make HeyGen long-form content.

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,886 B
  • docs SUMMARY.md 389 B

History

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

SKILL.md

YouTube to HeyGen Long-Form Avatar Video

Converts YouTube videos into long-form landscape avatar videos using your HeyGen AI clone. Two-step Gemini process: full script extraction → condensation to max 2000 words.

What It Does

  1. Sends YouTube URL to Gemini 2.0 Flash for full content analysis
  2. Generates a full Alex Hormozi-style script matching the original video's content
  3. Condenses to max 2000 words (~13-14 minute video at 150 words/min)
  4. Sends to HeyGen API for landscape video generation (1920x1080)
  5. Polls for completion (15-30 minutes) and stores in youtubelongform_heygen table

How to Run

# Generate long-form avatar video (default 2000 words max)
python3 skills/youtube-to-heygen-longform/scripts/youtube_to_heygen_longform.py "https://www.youtube.com/watch?v=VIDEO_ID"

# With custom word limit
python3 skills/youtube-to-heygen-longform/scripts/youtube_to_heygen_longform.py "https://www.youtube.com/watch?v=VIDEO_ID" --max-words 1500

# Start generation without waiting for completion
python3 skills/youtube-to-heygen-longform/scripts/youtube_to_heygen_longform.py "https://www.youtube.com/watch?v=VIDEO_ID" --no-wait

Configuration

Environment Variables

GEMINI_API_KEY=xxx
HEYGEN_API_KEY=xxx
HEYGEN_AVATAR_ID=xxx       # Your avatar clone ID
HEYGEN_VOICE_ID=xxx        # Your voice clone ID
DATABASE_URL=postgresql://...

Dependencies

pip install google-generativeai requests psycopg2-binary python-dotenv

Short-Form vs Long-Form Comparison

Feature Short-Form Long-Form
Max Words ~180 2000
Video Length ~60 seconds ~13-14 minutes
Dimension 1080x1920 (vertical) 1920x1080 (landscape)
Caption Yes No
Database Table geminivideoagent youtubelongform_heygen
Generation Time 2-5 minutes 15-30 minutes
Polling Interval 10 seconds 30 seconds
Timeout 10 minutes 30 minutes

Important Notes

  • Generation Time: 15-30 minutes for 10+ minute videos — be patient
  • Word Limit: ~150 words = 1 minute speaking time
  • Two-Step Gemini: First extracts full content, then condenses to target length
  • Newlines: Strip all \n literals — they cause unnatural pauses
  • Timeout: 30-minute timeout with 30-second polling intervals

Scripts

File Purpose
youtubetoheygen_longform.py Main long-form avatar video generator