How do I install the Youtube To Heygen Video skill?

Run npx skillmds@latest add kevinbadi/youtube-to-heygen-video in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Youtube To Heygen Video safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Youtube To Heygen Video?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Youtube To Heygen Video free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Youtube To Heygen Video?

kevinbadi (@kevinbadi) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Youtube To Heygen Video by kevinbadi

Name: Youtube To Heygen Video
Author: kevinbadi

Youtube To Heygen Video

Converts YouTube videos into short-form (60-second) avatar videos using HeyGen AI clone. Analyzes video with Gemini, generates Alex Hormozi-style script, creates vertical 1080x1920 avatar video with social media caption. Trigger when asked to create clone shorts, convert YouTube to avatar video, or make HeyGen short-form content.

kevinbadi Updated Sep 17, 2026

File contents

YouTube to HeyGen Avatar Video

Converts YouTube videos into 60-second vertical avatar videos using your HeyGen AI clone. Analyzes the video with Gemini AI, rewrites as an Alex Hormozi-style script, generates a social media caption, and creates the avatar video.

What It Does

Sends YouTube URL to Gemini 2.0 Flash for direct video analysis
Generates a ~180-word Alex Hormozi-style script (≈60 seconds of speaking)
Creates a social media caption with SEO keywords and hashtags
Sends script to HeyGen API for avatar video generation (1080x1920 vertical)
Polls for completion and stores video URL in gemini_video_agent database table

How to Run

# Generate avatar video from YouTube
python3 skills/youtube-to-heygen-video/scripts/youtube_to_heygen_video.py "https://www.youtube.com/watch?v=VIDEO_ID"

# Start generation without waiting for completion
python3 skills/youtube-to-heygen-video/scripts/youtube_to_heygen_video.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

Script Format (Alex Hormozi Style)

Hook (3-5 sec): Bold/contrarian statement, pattern interrupt
Body (60-70%): ONE core concept, 2-3 supporting points, short punchy sentences
Close (15-20 sec): Restate transformation, create urgency, comment CTA

Constraints

~180 words (≈60 seconds)
Max 4000 characters (HeyGen limit)
No \n literals (causes unnatural pauses)
No markdown formatting

HeyGen Settings

Setting	Value
Dimension	1080x1920 (vertical/shorts)
Background	#000000 (black)
Avatar Style	normal
Voice Emotion	Excited
Generation Time	2-5 minutes

Important Notes

Gemini: Can analyze YouTube URLs directly — no need to download videos
Script Length: Keep under 4000 characters or HeyGen truncates
Generation Time: 2-5 minutes; script polls every 10 seconds with 10-minute timeout
Newlines: Strip all \n literals — they cause unnatural pauses in avatar speech
Database: Stores video_id immediately, updates with URL after completion

Scripts

File	Purpose
`youtube_to_heygen_video.py`	Main short-form avatar video generator

---name: youtube-to-heygen-videodescription: Converts YouTube videos into short-form (60-second) avatar videos using HeyGen AI clone. Analyzes video with Gemini, generates Alex Hormozi-style script, creates vertical 1080x1920 avatar video with social media caption. Trigger when asked to create clone shorts, convert YouTube to avatar video, or make HeyGen short-form content.---# YouTube to HeyGen Avatar VideoConverts YouTube videos into 60-second vertical avatar videos using your HeyGen AI clone. Analyzes the video with Gemini AI, rewrites as an Alex Hormozi-style script, generates a social media caption, and creates the avatar video.## What It Does1. Sends YouTube URL to Gemini 2.0 Flash for direct video analysis2. Generates a ~180-word Alex Hormozi-style script (≈60 seconds of speaking)3. Creates a social media caption with SEO keywords and hashtags4. Sends script to HeyGen API for avatar video generation (1080x1920 vertical)5. Polls for completion and stores video URL in `gemini_video_agent` database table## How to Run```bash# Generate avatar video from YouTubepython3 skills/youtube-to-heygen-video/scripts/youtube_to_heygen_video.py "https://www.youtube.com/watch?v=VIDEO_ID"# Start generation without waiting for completionpython3 skills/youtube-to-heygen-video/scripts/youtube_to_heygen_video.py "https://www.youtube.com/watch?v=VIDEO_ID" --no-wait```## Configuration### Environment Variables```envGEMINI_API_KEY=xxxHEYGEN_API_KEY=xxxHEYGEN_AVATAR_ID=xxx # Your avatar clone IDHEYGEN_VOICE_ID=xxx # Your voice clone IDDATABASE_URL=postgresql://...```### Dependencies```bashpip install google-generativeai requests psycopg2-binary python-dotenv```## Script Format (Alex Hormozi Style)- **Hook** (3-5 sec): Bold/contrarian statement, pattern interrupt- **Body** (60-70%): ONE core concept, 2-3 supporting points, short punchy sentences- **Close** (15-20 sec): Restate transformation, create urgency, comment CTA### Constraints- ~180 words (≈60 seconds)- Max 4000 characters (HeyGen limit)- No `\n` literals (causes unnatural pauses)- No markdown formatting## HeyGen Settings| Setting | Value ||---------|-------|| Dimension | 1080x1920 (vertical/shorts) || Background | #000000 (black) || Avatar Style | normal || Voice Emotion | Excited || Generation Time | 2-5 minutes |## Important Notes- **Gemini**: Can analyze YouTube URLs directly — no need to download videos- **Script Length**: Keep under 4000 characters or HeyGen truncates- **Generation Time**: 2-5 minutes; script polls every 10 seconds with 10-minute timeout- **Newlines**: Strip all `\n` literals — they cause unnatural pauses in avatar speech- **Database**: Stores video_id immediately, updates with URL after completion## Scripts| File | Purpose ||------|---------|| `youtube_to_heygen_video.py` | Main short-form avatar video generator |

Frequently asked questions