beatra-ai/beatra-skills/audio-drama-voice-studio

Claude Code and agent skill by beatra-ai/beatra-skills

Trust tier 3
  • community
Source check pending

Checking that the SKILL.md file is still in the repository.

Give every character in your script its own voice and get the whole scene recorded line by line, in script order, as numbered clips ready to drop into your editor. This AI multi-character voice generator covers audio drama and radio play, dramatised fiction and audiobooks with a cast, dialogue voice over, two-host and panel shows, scripted ads with two roles, and course roleplay scenes: decide who is who first — age, temperament, how far apart the voices should sit — give the narrator a voice of their own, and afterwards re-record just the one line you want to change. Also used for audio drama voice generator work, multi-character voice generator work, multi-speaker audio, dialogue text to speech, script to dialogue audio, AI audio drama, radio play voices, and full cast voiceover.

Install

npx vskill@latest install beatra-ai/beatra-skills/audio-drama-voice-studio

SKILL.md

The same SKILL.md was published earlier as beatra-ai/beatra-skills/audio-drama-voice-studio.

Audio Drama Voice Studio

Give a script a cast. Assign one voice per character, plan expressive pacing without rewriting dialogue, record scenes natively with multi-speaker dialogue or block-by-block synthesis, add scene foley/ambience and -14 LUFS finishing when requested, and hand back ordered clips and aligned subtitles ready to assemble in your editor.

What you get

A finished run returns:

  • Numbered scene takes (beatra.speech.synthesize_dialogue) or per-block clips

(beatra.speech.synthesize), labelled with speaking roles in script order

  • A cast sheet: each speaker, age/temperament, how they contrast relative to

the others, and the opaque voice_id kept for the whole piece

  • Free aligned subtitles (output.subtitles: JSON, SRT, VTT, and dialogue

segments[]) when subtitle_enable: true (default; never pass subtitles)

  • Optional separately confirmed foley/ambience beds (beatra.audio.generate_sfx)

and finished clips (beatra.audio.process)

  • Actual returned duration, size, MIME type, resolved model, and

billing.net_charged_credits for every delivered clip

It does not mix multiple audio tracks into one layered episode master. Multi-track timeline mixing and SFX layering stay in the user's editor.

Ways to run it

  • Cast, direct, and record — default. Build the cast sheet, optionally run

Smart Voice Director (beatra.speech.prepare_script), audition free beatra.voices.preview clips, validate free with beatra.speech.validate_dialogue or beatra.speech.validate, then synthesize scenes via beatra.speech.synthesize_dialogue (or segmented beatra.speech.synthesize when cast limits or isolated-line control require it).

  • Add foley, ambience, and loudness finishing — optional, separately quoted.

Generate scene foley, stingers, or loop=true ambient beds (beatra.audio.generate_sfx) and run beatra.audio.process (isolate_voice, normalize_loudness, trim, fade). Never call any paid finishing or script-direction step free.

  • Add an owned voice — optional. Pre-clean noisy samples if needed

(isolate_voice), then clone a voice with explicit owner consent and full lifecycle confirmations (consent_attested, beatra.voices.activate when pending_activation, two-step beatra.voices.delete).

Casting, script drafting, beatra.voices.list, beatra.voices.preview, beatra.models.list, beatra.speech.validate, beatra.speech.validate_dialogue, beatra.voices.delete step 1, and tokenless beatra.voices.activate quote refreshes are free. Smart Voice Director (beatra.speech.prepare_script), synthesis, dialogue synthesis, cloning, trial activation, SFX, and beatra.audio.process are paid steps.

Scope and routing

Use this Skill when a script or dialogue passage needs more than one speaker: audio drama and radio play, dramatised fiction, audio novels with named roles, a two-host or panel show, a dialogue-driven course or training scene, a scripted ad with two or more roles, or an interactive story with distinct characters.

Route a single-narrator book or course to ai-audiobook-narration. Route a podcast episode to ai-podcast-voiceover, and a short-video voiceover to short-form-voiceover-audio. Route standalone cloning-only work to voice-cloning-studio when cloning is the whole job; if a character on this cast needs a cloned voice, clone and manage it right here. Route general single-voice work to beatra-ai-voice-studio, and narrated video with pictures to novel-promo-video-maker.

Inputs and defaults

The one hard input is the script text. Reuse the genre, era, tone, character notes, language, and any voice already chosen in the conversation.

Ask only when the answer changes the paid result: who speaks each line, when the passage is prose with no speaker attribution and the text does not settle it.

Defaults that avoid extra questions:

  • One opaque voice_id per named character, plus one narrator voice when the

script has narration.

  • Speaker order follows the script; nothing is reordered.
  • model omitted or "auto" unless a capability requires an explicit choice.
  • language omitted for automatic detection unless the user specifies one or

the script mixes several.

  • subtitle_enable: true (never pass subtitles) to obtain free timestamps and

aligned JSON/SRT/VTT subtitles (segments[] on dialogue).

  • Use native beatra.speech.synthesize_dialogue when the scene fits 2–50

turns, <= 2,000 characters, <= 10 voices with capabilities.supports_dialogue == true, and <= 4 ready clones (chunk longer scenes cleanly with previous_text / next_text). Fall back to segmented beatra.speech.synthesize when cast limits, dialect constraints, or single-line isolation apply.

Golden path

  1. Read the script and build the cast sheet: every speaking character, age,

temperament, relative contrast, and narrator if present. Split the script into speaker-attributed turns/scenes (noting <= 2,000-char dialogue scenes for native beatra.speech.synthesize_dialogue or individual blocks for beatra.speech.synthesize). Show the numbered cast sheet and script layout to the user as the free visible deliverable. Planning is not approval.

  1. Call beatra.voices.list (bilingual search, limit <= 500, cursor, facet

filters, supports_dialogue=true when targeting dialogue, inspecting all 11 capabilities.* metadata fields) only when voices are still needed or the user asks to browse/compare. Run free beatra.voices.preview (preview_url, kind) to audition picks and freeze one opaque voice_id per role.

  1. Optional Smart Voice Director: if dramatic beats, pause holds, or

expressive timing need compilation without changing dialogue words (never hand-author braced tags), quote and run paid beatra.speech.prepare_script ({"capability": "speech_script"}, max 2 concurrent; 48-hour same-script voice swap reuse when balance covers admission), inspect directed and scripts[] (resolving any synthesis: null from warnings), then pass ready scripts[].synthesis unchanged + fresh client_request_id.

  1. Read live cards via beatra.models.list (text_to_dialogue,

text_to_speech, speech_script, sound_effects, audio_process, audio_voice_isolation) and run free preflight (beatra.speech.validate_dialogue for dialogue scenes or beatra.speech.validate for single blocks) for live pricing, duration estimates, weighted characters (Han ideographs = 2, others = 1; linear per 1,000 with exact fractional charge under 1,000), and warnings.

  1. Show one current six-field production card covering the approved scene/blocks

(plus separate cards or itemized paid lines for any optional SFX or finishing steps) and wait. Never treat free planning as approval.

  1. Submit each approved call once via bundled scripts/mcp_client.py with its

own opaque client_request_id (beatra.speech.synthesize_dialogue or beatra.speech.synthesize, plus optional beatra.audio.generate_sfx or beatra.audio.process) and poll beatra.tasks.get until terminal.

  1. Deliver ordered clips, speaker labels, free aligned subtitles (segments[]),

actual duration, size, MIME type, artifact ID/URL, resolved model, and billing.net_charged_credits. Review only audio the host can actually play.

A single-line revision re-runs only the affected line or scene chunk under a new production card and client_request_id, leaving accepted clips untouched. See the audio drama workflow and speech, voices, cloning, and audio finishing.

Decisions that require confirmation

Planning, cast sheets, voice previews, and preflight quotes are free and never constitute approval. Before the first paid call, show a six-field production card:

  1. Work — exact scene/block scope, voices, language/format/controls, and any

requested prepare_script, audio.generate_sfx (prompt, duration_seconds 0.5–30.0, loop=true), or beatra.audio.process step (isolate_voice, normalize_loudness -14 LUFS, trim, fade).

  1. Credits — live rate/quote from beatra.models.list,

beatra.speech.validate_dialogue, or beatra.speech.validate. Never guess or promise an estimate is final.

  1. Count — exact number of paid calls approval creates. A changed line or

parameter is a new call.

  1. Identity — one fresh caller-generated opaque client_request_id per paid

call. Never reuse an ID across clips or changed parameters.

  1. If we stop here — the cast sheet, script layout, audition picks, and any

already-delivered clips remain usable at zero extra charge (or nothing paid yet before the first submit).

  1. If the balance is insufficient — relay Beatra's official message and exact

top-up URL verbatim without modifying the URL, and wait until the user says they have topped up before retrying with the same frozen client_request_id.

Submit once through bundled scripts/mcp_client.py. Poll beatra.tasks.get.

Voice cloning requires three separate mandatory confirmations alongside its own card (voice_clone, voices.activate, voices.delete); a synthesis card never authorizes cloning, SFX, or finishing steps not listed on that card.

Using a cloned voice (3 mandatory confirmations)

Follow the full consent and activation flow in speech, voices, cloning, and audio finishing:

  1. Noisy sample check (paid): if a recording has music, street noise, or

room echo, propose paid beatra.audio.process (operation="isolate_voice", {"capability": "audio_voice_isolation"}, 4.6 s – 5 min, <= 100 MB) on its own card first.

  1. Confirmation #1 — Consent (`consent_attested: true`): obtain explicit

confirmation in this conversation that the user owns the voice or holds the speaker's permission before uploading via scripts/mcp_client.py upload. Possession of an audio file is never consent.

  1. Inspect all 3 cloning routes live: call beatra.models.list with

{"capability": "voice_clone", "include_activation_required": true} (fast auto ready immediately, 10-language expressive/dialogue/S2S clone, or free-trial training returning status="pending_activation"). Present the six-field clone card and wait before calling beatra.voices.clone.

  1. Confirmation #2 — Trial activation (`beatra.voices.activate`): a clone is

NOT guaranteed to be immediately activated — if beatra.voices.clone returns status="pending_activation", show the live activation quote (activation.quote, or refresh free using voice_id + client_request_id omitting confirmation_token if the 24-hour token expires), obtain explicit user approval of both credits and terms, then call beatra.voices.activate with voice_id, confirmation_token, confirm_credits, and a fresh client_request_id.

  1. Confirmation #3 — Two-step permanent deletion (`beatra.voices.delete`):

when deleting a clone, first call beatra.voices.delete with voice_id only, display paid_slot_warning, irreversible_notice, and 15-minute token_expires_at, wait for explicit confirmation, then call step 2 with voice_id and confirmation_token.

Do not offer a free clone or a free sample that replaces a paid clone. Detailed payloads and sample bounds live in the audio drama workflow.

Account balance

When the user asks how many credits remain or whether a live estimate fits, call read-only beatra.wallet.get. When they ask what was charged, call beatra.wallet.ledger. Never make beatra.wallet.get a mandatory gate before submitting, and never ask the user to confirm they have enough credits. If a model card carries a top_up block, relay its tiers verbatim in listed order without ranking or picking one.

This is the start of the file. Read the full SKILL.md on GitHub.

Security

  • Security scanPassed, 95 of 100Pattern checks on the skill's files.
  • Model reviewPassed

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
2
7-day trend score
10

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/beatra-ai/beatra-skills/audio-drama-voice-studio/badge)](https://verified-skill.com/skills/beatra-ai/beatra-skills/audio-drama-voice-studio)

Something wrong with this skill or its page? Tell us.