alexansart/demo-studio

narrate

Generates a narration voiceover .mp3 for a demo video script using the ElevenLabs API — configurable voice/model/stability, deterministic output filename.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/alexansart/demo-studio --skill narrate

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Narrate — generate a voiceover with ElevenLabs

Turns a plain-text script into an .mp3 narration track. This is stage 1 of the full pipeline (produce-video); use it standalone if you already have a silent video and just need the voice.

Requires ELEVENLABS_API_KEY (see .env.example at the project root — get a key at https://elevenlabs.io). No key, no narration — produce-video and film-demo both work fine without this skill (silent video only).

Quick start

bash
pip install -r scripts/requirements.txt   # once

python scripts/generate_narration.py \
  --out demos/<slug>/narration.mp3 \
  --text "Here's how it works. Type your task, hit add, and watch it appear instantly."

Or --text-file script.txt for longer scripts. The script writes exactly one .mp3 at --out — no auto-naming, so it composes cleanly into a pipeline.

Defaults (override via flags or demo.config.json → narration)

SettingDefaultFlag
Voice"Rachel" (search by name in your ElevenLabs voice library)--voice-name
Voice ID (skips the name search)—--voice-id
Modeleleven_v3--model
Stability1.0 (Robust — v3 scale: 0.0 Creative, 0.5 Natural, 1.0 Robust)--stability
Output formatmp3_44100_128--format

Pick a voice from your own ElevenLabs account (or a shared voice you've added to your library) and set it once in demo.config.json → narration.voiceName so every video in the project uses the same voice. --voice-name does a voices.search() by exact name — if you get "voice not found", the voice either isn't in your account yet (add it from the ElevenLabs Voice Library first) or the name doesn't match exactly; pass --voice-id instead to skip the search entirely.

Script-writing rules (these make sync easier later)

  • Plain sentences, one idea each. sync-narration aligns and cuts at

sentence boundaries — a 40-word sentence covering three on-screen actions cannot be split apart later.

  • Write to match the pacing you'll film, not the other way around. ~150

words/minute is natural TTS speed — a 60-90s video needs roughly 150-220 words of narration.

  • No stage directions or brackets ("[pause]", "(click here)") — the model

reads them aloud. Convey pacing with actual punctuation and sentence breaks.

  • Say what's on screen in the order it happens. sync-narration maps

sentence order to beat order 1:1 — reordering later means re-aligning.

Gate before moving on

bash
ffprobe -v error -show_entries format=duration -of csv=p=0 demos/<slug>/narration.mp3

Confirm the duration is plausible for the word count (~150 wpm). Regenerating costs API credits — only do it when the script text actually changes; reuse the existing .mp3 otherwise.

Deliverable

Report the output path, duration, voice/model used, and word count. If ELEVENLABS_API_KEY is missing, say so explicitly and stop — do not silently fall back to a different provider or skip narration without telling the user.

from this repository

More skills

All skills
alexansart
Community

demo-setup

One-time setup that analyzes the current project and configures it to use the film-demo / narrate / sync-narration / produce-video skills — detects the dev server and framework, asks only when necessary, generates demo.config.json and .env entries, vendors the recording engine and project helpers, and scaffolds a first demo from reference patterns. Use when the user asks to set up, configure, or install demo-studio / video-recording skills for this project, or before running produce-video for th

1h installs
1
GitHub stars
5
Updated
Jul 26
alexansart
Community

film-demo

Records a polished, silent screen-capture demo video of any web app from a plain-English beat script — Playwright capture with a real cursor, human-speed typing, explicit zone-based zooms (focus/wide) with guaranteed containment, deterministic guardrails (cursor offscreen, zoom too long, inactivity), annotated frame inspection, post-record speed-ups, styled frame, and a verify/iterate loop. Use when the user asks to record, film, or generate a demo/tutorial/product video of a web app.

1h installs
1
GitHub stars
5
Updated
Jul 26
alexansart
Community

produce-video

End-to-end production of a narrated, captioned demo video for any web app — chains narration generation (narrate), silent Playwright recording (film-demo, smart zooms + guardrails), and narration sync with burned captions (sync-narration) into one final .mp4. Use when the user asks to produce, make, or film a demo/product/tutorial video end to end, "with voice and subtitles", or "from A to Z".

1h installs
1
GitHub stars
5
Updated
Jul 26
alexansart
Community

sync-narration

Syncs a separately-recorded narration track onto a silent screen recording — pads audio with calculated pauses to match on-screen pacing (no voice during cursor movement), then burns styled captions. Use when the user provides a silent screen-recorded video plus a narration .mp3 and asks to sync/combine/caption them.

1h installs
1
GitHub stars
5
Updated
Jul 26