video-audio

Generate per-scene or merged MP3 narration audio from scenes.json using ElevenLabs TTS.

345|12|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/minicoohei/ai-agent-camp --skill video-audio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: video-audio
Source: https://github.com/minicoohei/ai-agent-camp/tree/main/.claude/skills/video-audio
Command: npx skills add https://github.com/minicoohei/ai-agent-camp --skill video-audio

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill automates the generation of narration audio from scenes.json narrations using ElevenLabs TTS, enabling video projects to have consistent, timestamped voice-overs without manual recording.

Core Features & Use Cases

  • TTS-powered narration: Convert narration fields into MP3 audio aligned to video scenes.
  • Per-scene or merged output: Produce audio per frame or a single combined narration track, with timestamps for synchronization.
  • Use Case: Build a video with scene-by-scene narration by feeding a storyboard's scenes.json and configuring voice, model, and timing.

Quick Start

Run the skills/video-audio/scripts/generate_audio.py script with your storyboard directory and a chosen voice to generate narration audio.

Frequently Asked Questions about video-audio

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate synchronized voice-over audio for video scenes?

To generate synchronized voice-over audio for video scenes, you can use a script that converts storyboard narration text into speech audio with timestamps. This process uses ElevenLabs TTS to read scenes.json narration fields and outputs per-scene or merged audio tracks aligned for synchronization.

What is a scenes.json narration file and how does it work with TTS?

A scenes.json narration file contains text fields for individual video scenes. When processed with a TTS engine like ElevenLabs, these text fields are converted into MP3 speech audio, matched to each scene, and merged with timestamps for video synchronization.

Do I need an ElevenLabs API key to convert storyboard narration to speech?

Yes, you need an ELEVEN_API_KEY to convert storyboard narration to speech using ElevenLabs TTS. You also need Python 3.11 or higher installed, along with a storyboard directory containing your scenes.json file with properly formatted narration fields.

Can I produce a single merged narration track instead of per-scene audio?

Yes, you can produce a single merged narration track instead of per-scene audio. The generation script supports both output modes, allowing you to create either individual MP3 files for each scene or one combined audio file with timestamps for full video synchronization.

What's the best way to add timestamped text-to-speech to a video storyboard?

The best way to add timestamped text-to-speech to a video storyboard is to automate the process using a TTS script. By feeding your scenes.json file into an ElevenLabs-powered generator, you automatically receive synchronized audio tracks aligned with your scene timings.

Why does my scenes.json narration audio generation require Python 3.11?

Your scenes.json narration audio generation requires Python 3.11 or higher because the underlying TTS script depends on features and libraries available in this version. Running the script below this version may cause compatibility errors during the ElevenLabs API audio synthesis process.