voiceai-creator-voiceover-pipeline

name	voiceai-creator-voiceover-pipeline
description	Turn scripts into publishable voiceovers with Voice.ai TTS, including segments, chapters, captions, and video muxing.
version	0.2.1
env	["VOICE_AI_API_KEY"]
required_env	["VOICE_AI_API_KEY"]
credentials	["VOICE_AI_API_KEY"]
setup	none — single file, runs directly with Node.js
runtime	node>=20
optional_deps	ffmpeg

Voice.ai Creator Voiceover Pipeline

This skill follows the Agent Skills specification.

Turn any script into a publish-ready voiceover — complete with numbered segments, a stitched master, YouTube chapters, SRT captions, and a beautiful review page. Optionally, replace the audio track on an existing video.

Built for creators who want studio-quality voiceovers without the studio. Powered by Voice.ai.

---

When to use this skill

Scenario	Why it fits
YouTube long-form	Full narration with chapter markers and captions
YouTube Shorts	Quick hooks with the shortform template
Podcasts	Consistent host voice, intro/outro templates
Course content	Professional narration for educational videos
Quick iteration	Smart caching — edit one section, only that segment re-renders
Video audio replacement	Drop AI voiceover onto screen recordings or B-roll

---

The one-command workflow

Have a script and a video? Turn them into a finished video with AI voiceover in one shot:

node voiceai-vo.cjs build \
  --input my-script.md \
  --voice oliver \
  --title "My Video" \
  --video ./my-recording.mp4 \
  --mux

This renders the voiceover, stitches the master audio, and drops it onto your video — all in one command. Output:

• out/my-video/muxed.mp4 — your video with the new voiceover
• out/my-video/master.wav — the standalone audio
• out/my-video/review.html — listen and review each segment
• out/my-video/chapters.txt — YouTube-ready chapter timestamps
• out/my-video/captions.srt — SRT captions

Use --sync pad if the audio is shorter than the video, or --sync trim to cut it to match.

---

Requirements

• Node.js 20+ — runtime (no npm install needed — the CLI is a single bundled file)