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.

Ver código-fonte

Como usar

  1. Copie o comando e verifique o pacote antes de instalar no seu ambiente de agente.
  2. Consulte no original as ferramentas, credenciais e ambientes necessários.
  3. Descreva os dados de entrada e a entrega esperada; confira a saída com as fontes.
npx skills add https://github.com/alexansart/demo-studio --skill narrate

Antes de começar

  • A instalação não inclui assinatura de modelo, franquia API ou acesso aos seus arquivos.
  • Estrelas e instalações indicam atividade, não um teste independente de qualidade ou segurança.
Documento original do Skill

Renderizado do repositório de origem, preservando títulos, exemplos, código, tabelas, links e imagens.

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.

do mesmo repositório

Mais Skills

Todos os Skills
alexansart
Comunidade

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

Instalações / 1h
1
GitHub Stars
5
Atualizado
26 de jul.
alexansart
Comunidade

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.

Instalações / 1h
1
GitHub Stars
5
Atualizado
26 de jul.
alexansart
Comunidade

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".

Instalações / 1h
1
GitHub Stars
5
Atualizado
26 de jul.
alexansart
Comunidade

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.

Instalações / 1h
1
GitHub Stars
5
Atualizado
26 de jul.