teamday-ai/agents/youtube-video-creator

# 1. Create project directory
mkdir -p ~/videos/my-project/audio
 
# 2. Write a script (see JSON format below)
# 3. Generate visuals (screenshots, HTML slides, or AI images per scene)
 
# 4. Generate narration
bun .claude/scripts/generate-narration.ts --script ~/videos/my-project/script.json --output-dir ~/videos/my-project/audio
 
# 5. Assemble video
bun .claude/scripts/assemble-video.ts --script ~/videos/my-project/script.json --output ~/videos/my-project/final.mp4
 
# 6. Upload (optional, needs youtube-auth.ts setup first)
bun .claude/scripts/upload-youtube.ts --video ~/videos/my-project/final.mp4 --script ~/videos/my-project/script.json

Topic/Brief
    |
    v
[Write script.json] --- scenes[], narration, image prompts, metadata
    |
    v
[Generate visuals] --- AI images (generate-image skill) or HTML screenshots
[Generate narration] --- ElevenLabs TTS (generate-narration.ts)
[Optional: AI video clips] --- FAL AI Kling/Wan (image-to-video skill)
    |
    v
[Assemble video] --- FFmpeg: Ken Burns + crossfades + narration + music
    |
    v
[Upload to YouTube] --- YouTube Data API v3 (resumable upload)

{
  "title": "Video Title",
  "description": "YouTube video description",
  "tags": ["tag1", "tag2"],
  "category": "28",
  "privacy": "private",
  "scenes": [
    {
      "id": "scene-1",
      "narration": "Text to speak",
      "imagePrompt": "Prompt for AI image generation",
      "type": "ken-burns",
      "imagePath": null,
      "audioPath": null,
      "audioDuration": null,
      "videoClipPath": null
    }
  ],
  "backgroundMusic": "/path/to/music.mp3",
  "backgroundMusicVolume": 0.05,
  "voice": {
    "voiceId": "21m00Tcm4TlvDq8ikWAM",
    "modelId": "eleven_multilingual_v2",
    "stability": 0.5,
    "similarityBoost": 0.75,
    "speed": 1.0
  }
}

# Standalone
bun .claude/scripts/generate-narration.ts --text "Hello" --output ./hello.mp3
 
# Batch (from script)
bun .claude/scripts/generate-narration.ts --script ./script.json --output-dir ./audio
 
# List voices
bun .claude/scripts/generate-narration.ts --list-voices

bun .claude/scripts/assemble-video.ts \
  --script ./script.json \
  --output ./final.mp4 \
  --resolution 1920x1080 \
  --transition fade \
  --fps 30

bun .claude/scripts/youtube-auth.ts --credentials ./client_secret.json

bun .claude/scripts/upload-youtube.ts \
  --video ./final.mp4 \
  --script ./script.json \
  --privacy private