akcodez/promo-video-skill

How It Works

  Your Repo                    Claude Code                     Output
 ┌──────────┐    ┌───────────────────────────────┐    ┌─────────────────┐
 │ code     │    │  1. Scan codebase             │    │ landscape.mp4   │
 │ logo     │───>│  2. Creative direction        │───>│ 1920 x 1080     │
 │ readme   │    │  3. Build Remotion scenes     │    ├─────────────────┤
 │ colors   │    │  4. Generate AI voiceover     │    │ portrait.mp4    │
 └──────────┘    │  5. Render + combine audio    │    │ 1080 x 1920     │
                 └───────────────────────────────┘    └─────────────────┘

Quick Start

1. Install the skills

Open any terminal and run:

npx skills add remotion-dev/skills         # Remotion fundamentals (peer dependency)
npx skills add AKCodez/promo-video-skill   # Promo video workflow

This installs two Claude Code skills — one teaches Claude how to write Remotion code, the other teaches Claude how to produce a complete promo video.

2. Get your ElevenLabs API key

Sign up for free at elevenlabs.io → go to Profile → API Keys → copy your key.

Then set it in your environment:

# macOS / Linux
export ELEVENLABS_API_KEY="sk_your_key_here"

# Windows PowerShell
$env:ELEVENLABS_API_KEY = "sk_your_key_here"

3. Open Claude Code in your project

Navigate to the repo you want to create a video for, then launch Claude Code:

cd ~/your-saas-project
claude                            # opens Claude Code CLI

Or open the project folder in VS Code with the Claude Code extension, or use the Claude Code desktop app.

4. Prompt Claude

Once Claude Code is running, just type a prompt. Claude will scan your repo, ask you creative questions, and build everything.

Simple:

Create a promo video for this project

With direction:

Create a 60-second dark mode promo video targeting developers

Detailed:

Create a 90-second promo video for this Chrome extension. Use the Rage Hook 
narrative — open with someone frustrated, then reveal the product. Dark theme, 
dramatic male voice, metallic swoosh transitions.

That’s it. Claude handles the rest — scanning your codebase, building scenes, generating voiceover, and rendering both landscape and portrait MP4s.

---

Example Prompts

Different prompts give different results. Here are directions you can give Claude:

---

The Pipeline

---

Voiceover Emotional Presets

The AI voice changes emotion per scene — not one flat tone for the whole video.

Narrative Templates

Four proven story structures, each with scene breakdowns and voiceover tone guides:

Available Voices

Built-in (Free Tier)

Don’t see what you want? Say “Browse ElevenLabs voices for a sinister dramatic male voice” and Claude will search the library, generate test samples, and let you audition them.

---

What’s Inside

skills/promo-video/
│
├── SKILL.md                     Main skill — 5-phase workflow
├── voiceover.md                 ElevenLabs + Whisper timing guide
├── narrative-templates.md       4 story structures with scene breakdowns
├── multi-format.md              Responsive 16:9 + 9:16 architecture
├── brand-discovery.md           Auto-detect logos, colors, fonts
├── metallic-swoosh.md           Custom metallic shine transition
├── promo-patterns.md            Visual inspiration catalog
│
├── scripts/
│   ├── preflight.ts             Environment validation
│   ├── discover-brand.ts        Repo scanner for brand assets
│   ├── discover-voices.ts       ElevenLabs voice browser + sampler
│   ├── timing-calculator.ts     TransitionSeries duration math
│   └── generate-voiceover.ts    Full voiceover generation pipeline
│
└── music/
    ├── inspired-ambient.mp3     Ambient, atmospheric
    ├── motivational-day.mp3     Commercial, uplifting
    └── upbeat-corporate.mp3     Inspiring, energetic

Utility Scripts

All TypeScript, all cross-platform. Run with npx tsx.

---

Prerequisites

About the Remotion Skill

This skill depends on remotion-dev/skills — the official Remotion skill with 30+ rule files:

The Remotion skill teaches Claude how to write Remotion code. This skill teaches Claude how to produce a complete promo video.

About ffmpeg

You do not need to install ffmpeg. This skill uses bunx remotion ffmpeg — bundled, cross-platform, zero PATH configuration. Works on Windows, macOS, and Linux out of the box.

---

Tips

• Be specific about your audience. “College students struggling with online quizzes” > “students”
• Pick 3-5 features max. More dilutes the message.
• Use the Rage Hook for consumer products — highest engagement.
• Keep scenes to 2-4 seconds. Shorter = more engaging.
• Preview before voiceover. Run npx remotion studio after building scenes.

Troubleshooting

---