generate-narration-audio

Generates per-segment TTS narration audio for voiceover scripts via MCP tool calls.

4.3k|859|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/ArcReel/ArcReel --skill generate-narration-audio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: generate-narration-audio
Source: https://github.com/ArcReel/ArcReel/tree/main/agent_runtime_profile/.claude/skills/generate-narration-audio
Command: npx skills add https://github.com/ArcReel/ArcReel --skill generate-narration-audio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Producing narration voiceovers for commentary-style video scripts requires synthesizing audio for every storyboard segment, tracking which segments are missing audio, and recovering cleanly when batch generation is interrupted. This Skill automates that entire TTS production loop inside the ArcReel pipeline.

Core Features & Use Cases

  • Batch Narration Synthesis: Enqueue TTS generation for all segments missing narration audio in an episode script, writing results to each segment's generated_assets.narration_audio.
  • Targeted Regeneration: Re-synthesize specific segments by ID when voice or speed settings change, while reusable existing audio is preserved.
  • Resumable Recovery: After interruptions such as service restarts or task failures, rerun the full-episode fill to skip completed segments and only synthesize missing ones without duplicate billing.
  • Use Case: After generating a script for episode 1, ask the assistant to produce narration audio for all segments; if the worker crashes mid-batch, simply re-invoke the same command to finish only the remaining segments.

Quick Start

Generate narration audio for every segment missing it in episode_1.json and show me the per-segment results.

Frequently Asked Questions about generate-narration-audio

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

FAQPage Schema
How do I generate TTS narration audio for a video script?

Call the generate_narration_audio MCP tool with the episode script filename to enqueue synthesis for every segment missing narration audio. Results are written back to each segment's generated_assets.narration_audio as a WAV file.

How do I regenerate narration for specific segments after changing voice settings?

Pass the segment_ids parameter with the exact segment IDs to regenerate. Explicitly listed segments are re-synthesized even if audio already exists, which is required after changing voice or speed settings.

Can I resume an interrupted batch narration generation?

Yes, re-invoke the tool without segment_ids to run a full-episode fill. Segments that already have narration audio are skipped automatically, so only missing segments are synthesized without duplicate charges.

Does missing TTS narration block video export?

No, missing TTS audio is not a workflow gap and does not block export. Videos using post-production voiceover work without any TTS, and narration generation should only run when the user requests it.

Why does narration generation fail with an audio provider error?

The tool requires an audio provider, model, and default voice configured in the web settings page, plus an online generation worker. If no provider is configured, post-production voiceover remains available as an alternative.