voiceai-voiceover-creator
by gizmogremlin
Coding Agents & IDEsBrief
Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing.
Description
What This Skill Does
Converts text scripts into voiceovers using Voice.ai TTS, producing numbered audio segments, a stitched master file, YouTube chapter markers, SRT captions, and an HTML review page. Optionally replaces the audio track on an existing video using ffmpeg. Caches segments by content hash so only changed sections re-render on rebuild.
Segment-level caching means editing one section of a long script only re-renders that segment, avoiding full re-renders common in batch TTS tools.
When to Use It
- Narrating a YouTube video with chapter timestamps
- Adding captions to a screen recording
- Replacing audio on B-roll footage
- Generating podcast episodes with consistent host voice
- Iterating on course narration without re-rendering unchanged sections
Example Workflow
User asks: turn my-script.md into a voiced video using the oliver voice and mux it onto my-recording.mp4
- 1
Reads my-script.md and splits it into segments by ## headings
- 2
Calls Voice.ai TTS API for each segment, skipping any cached unchanged segments
- 3
Stitches segments into master.wav using ffmpeg
- 4
Generates chapters.txt, captions.srt, and review.html
- 5
Muxes master.wav onto my-recording.mp4, outputting muxed.mp4
out/my-video/muxed.mp4 with AI voiceover, plus master.wav, review.html, chapters.txt, and captions.srt
Requirements
- VOICE_AI_API_KEY environment variable — obtain at voice.ai/dashboard
Installation
clawhub install gizmogremlin/voiceai-voiceover-creatorRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.