beatra-ai/beatra-skills/audio-drama-voice-studio
Claude Code and agent skill by beatra-ai/beatra-skills
- community
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-studioSKILL.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_idper named character, plus one narrator voice when the
script has narration.
- Speaker order follows the script; nothing is reordered.
modelomitted or"auto"unless a capability requires an explicit choice.languageomitted for automatic detection unless the user specifies one or
the script mixes several.
subtitle_enable: true(never passsubtitles) to obtain free timestamps and
aligned JSON/SRT/VTT subtitles (segments[] on dialogue).
- Use native
beatra.speech.synthesize_dialoguewhen the scene fits2–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
- 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.
- Call
beatra.voices.list(bilingualsearch,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.
- 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.
- 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.
- 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.
- Submit each approved call once via bundled
scripts/mcp_client.pywith 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.
- 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:
- 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).
- Credits — live rate/quote from
beatra.models.list,
beatra.speech.validate_dialogue, or beatra.speech.validate. Never guess or promise an estimate is final.
- Count — exact number of paid calls approval creates. A changed line or
parameter is a new call.
- Identity — one fresh caller-generated opaque
client_request_idper paid
call. Never reuse an ID across clips or changed parameters.
- 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).
- 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:
- 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.
- 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.
- Inspect all 3 cloning routes live: call
beatra.models.listwith
{"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.
- 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.
- 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
- SKILL.md in the repositoryCheckingskills/audio-drama-voice-studio/SKILL.md
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
[](https://verified-skill.com/skills/beatra-ai/beatra-skills/audio-drama-voice-studio)