AI Video Clipper

Transform long-form YouTube videos or local video files into viral-ready short clips for Instagram Reels and TikTok using AI-powered analysis.

---

Quick Start (Choose One)

Option 1: Use with an AI Assistant (Easiest)

Give the skill file to your AI assistant (Claude Code, Codex, etc.):

"Install this skill: universal-video-clipper.skill"

Then simply ask:

“Create viral clips from this YouTube video: https://www.youtube.com/watch?v=VIDEO_ID”

Option 2: Use with Claude Code / Codex

Tell your AI assistant to install this project:

"Install this project into your skill catalog"

The AI will automatically use the skill when you ask for video clips.

Option 3: Run Directly (No AI)

python ai_clip_generator.py "https://www.youtube.com/watch?v=VIDEO_ID"
python ai_clip_generator.py "/path/to/video.mp4"

---

How to Use This Tool

Once installed (or running directly), use natural language:

For YouTube Videos

“Create viral clips from this YouTube video: https://www.youtube.com/watch?v=VIDEO_ID”

“Turn this YouTube video into Instagram Reels: [URL]”

“Create viral clips from this YouTube video with animated captions: [URL]”

“Extract the best highlights from this tutorial for TikTok”

For Local/Uploaded Videos

“Create short clips from this video file: /path/to/video.mp4”

“Make Reels from my uploaded video”

“Make Reels from my uploaded video with scaling caption style”

With Additional Options

“Create 5 viral clips from this video with animated captions”

“Extract highlights from this YouTube video, skip downloading since I already have it”

---

What This Tool Does

1. Analyzes your video - Downloads (YouTube) or ingests (local files) the source video
2. Transcribes audio - Uses Whisper to create timestamped text transcripts
3. Finds viral moments - AI analyzes the content for engaging clips (hooks, value bombs, demos)
4. Generates clips - Creates 15-60 second clips optimized for social media
5. Formats for platforms - Outputs both standard and 9:16 vertical versions

---

What You Get

For each video processed, you’ll receive:

• Standard clips - Original aspect ratio versions
• Instagram versions - 9:16 vertical format (1080x1920) with padding
• Captioned variants - Optional animated word-by-word captions (CapCut-style)
• Summary report - Suggested captions, hashtags, virality scores

Sample Output

downloads/{video_id}/
├── original.mp4                    # Source video
├── original.json                   # Transcript with timestamps
├── metadata.json                   # Video info
├── analysis_request.md             # AI analysis prompt
├── clip_recommendations.json       # AI-generated clip suggestions
├── SUMMARY.md                      # Final report with captions & hashtags
└── clips/
    ├── clip_001_hook.mp4           # Standard clip
    ├── clip_001_hook_instagram.mp4 # 9:16 vertical