elevenlabs
Generate AI voiceovers, sound effects, and music using ElevenLabs APIs
Install / Use
npx skills add digitalsamba/claude-code-video-toolkit --skill elevenlabsInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Our assessment of elevenlabs
elevenlabs scores 91/100 on our quality scale, 77th of 331 Other skills we index (top 24%).
Its SKILL.md is 17 KB long, well organised into 33 sections with 20 code examples: a thorough specification that gives an agent plenty to work with.
With 2,544 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 5 days ago, so elevenlabs is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit β read the skill file before letting an agent act on it.
elevenlabs compared with similar skills
All 4 of these similar skills score higher than elevenlabs; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| elevenlabs (this skill)by digitalsamba | 91 | 2.5k | 5d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 112.7k | 9d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.9k | today | CLAUDE.md |
| Scraplingby D4Vinci | 100 | 103.9k | today | MCP Server |
| crawl4aiby unclecode | 100 | 87.5k | today | MCP Server |
Frequently asked questions
- How do I install elevenlabs?
- Run
npx skills add digitalsamba/claude-code-video-toolkit --skill elevenlabs. The install tabs above show the steps for each supported agent. - Which AI agents does elevenlabs work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is elevenlabs safe to use?
- It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is elevenlabs still maintained?
- The repository was last updated 5 days ago, so elevenlabs is actively maintained.
Skill content
View source on GitHubname: elevenlabs description: Generate AI voiceovers, sound effects, and music using ElevenLabs APIs. Use when creating audio content for videos, podcasts, or games. Triggers include generating voiceovers, narration, dialogue, sound effects from descriptions, background music, soundtrack generation, voice cloning, or any audio synthesis task.
ElevenLabs Audio Generation
Requires ELEVENLABS_API_KEY in .env.
Text-to-Speech
from elevenlabs.client import ElevenLabs
from elevenlabs import save, VoiceSettings
import os
client = ElevenLabs(api_key=os.getenv("ELEVENLABS_API_KEY"))
audio = client.text_to_speech.convert(
text="Welcome to my video!",
voice_id="JBFqnCBsd6RMkjVDRZzb",
model_id="eleven_multilingual_v2",
voice_settings=VoiceSettings(
stability=0.5,
similarity_boost=0.75,
style=0.5,
speed=1.0
)
)
save(audio, "voiceover.mp3")
Models
| Model | Quality | SSML Support | Notes |
|-------|---------|--------------|-------|
| eleven_multilingual_v2 | Highest consistency | None | Stable, production-ready, 29 languages. Toolkit default; supports style + speed |
| eleven_v4 | Most expressive | None (audio tags, IPA) | Newest (released 2026-09-28), 90+ languages, best clone accuracy. Stability + similarity only, no style/speed |
| eleven_flash_v2_5 | Good | <break>, <phoneme> | Fastest, cheapest; supports pause/pronunciation tags |
| eleven_v3 | Expressive | None | Previous generation β prefer v4 |
Choose: multilingual_v2 for reliability and speed/style control, v4 for maximum expressiveness and cloned voices (test a few takes), flash for SSML control.
Deprecated: eleven_turbo_v2_5 β use eleven_flash_v2_5 (same quality, lower latency; see deprecated models). The toolkit still accepts --model eleven_turbo_v2_5: it prints a one-line warning and sends eleven_flash_v2_5.
Eleven v4
Released 2026-09-28 (changelog, model page). The toolkit calls v4 through the Text to Dialogue API with one input (the narrator voice), as ElevenLabs recommends for content creation and long-form audio:
from elevenlabs import DialogueInput
audio = client.text_to_dialogue.convert(
inputs=[DialogueInput(text="[warm] Welcome to my video!", voice_id="JBFqnCBsd6RMkjVDRZzb")],
model_id="eleven_v4",
settings={"stability": 0.5, "similarity": 0.75}, # the only two settings v4 takes
)
save(audio, "voiceover.mp3")
uv run tools/voiceover.py --model eleven_v4 ...(andredub.py --model eleven_v4) do this for you, warn once that--style/--speedare ignored, and split text over ~2,000 chars per request (the reliable dialogue limit) at sentence boundaries. Pace with--max-wpminstead of--speed.client.text_to_dialogue.convert_with_timestamps(...)returns the same character alignment as TTSconvert_with_timestamps, soredub.py --syncworks with v4 and sends the same stability + similarity.- Pass
settingsas a dict: SDK versions before 2.69 type it with a stability-only model. The API readssimilaritythere since 2026-09-28 (it rejects an out-of-range value with a 422). Text to Dialogue needselevenlabs>=2.21. - Direct delivery with audio tags (
[whispering],[warm],[sigh]) and punctuation. Write tags that clearly describe the voice, because v4 can also read a tag as a sound effect. - A voice can change accent on one word. A British library voice read "thirty dollars" and "once a card is
on the account" with an American r, in every plain retake of those lines. A direction at the start of the line
held the accent in three takes of three:
[crisp British English accent] So what does thirty dollars buy?. v4 doesn't read the tag aloud. Put it in the text sent for voicing only, and keep the.txtbeside the MP3 as the spoken words, since captions are spelled from it. It can be measured before anyone listens: with the word times fromcaptions.py, an American r pulls the third formant under about 2,200 Hz at the end of "dollars" or "card" in a woman's voice, and a British ending leaves it near 2,700 (Praat,uv sync --extra prosody).templates/howto/scripts/accent.pydoes this for a folder of narration (--scenes DIR) and lists the lowest first. A word before a vowel reads low in British speech too ("your account" has a linking r), so listen to what it flags before re-voicing. - A pace direction slows a line a little. v4 ignores speed, but
[crisp British English accent, measured and unhurried]at the start gave takes about 8% longer than the same line without "measured and unhurried" (four takes of three lines). For an opening line, make three or four takes and letpick_takes.pychoose. Its wpm counts the words of the tag, so put the spoken words back in each take's.txtbefore picking, not only beforecaptions.py: with the tag still there it read 33 lines as 180 to 300 wpm and slowed 31 of them, where the true paces were 150 to 185 and 6 needed a touch. eleven_v4_turbois the real-time variant, available only over the Text to Dialogue WebSocket. The toolkit doesn't use it, since offline renders don't benefit from low latency.
Voice Settings by Style
| Style | stability | similarity | style | speed | |-------|-----------|------------|-------|-------| | Natural/professional | 0.75-0.85 | 0.9 | 0.0-0.1 | 1.0 | | Conversational | 0.5-0.6 | 0.85 | 0.3-0.4 | 0.9-1.0 | | Energetic/YouTuber | 0.3-0.5 | 0.75 | 0.5-0.7 | 1.0-1.1 |
voiceover.py's own defaults (stability 0.85, style 0.0) sit at the top of the first row: steady but flat. A
library voice picked for its preview usually sounds slower and duller at those defaults than in the preview.
Lower the stability first (0.45 on v4 brought Marilyn back to her preview's pace and pitch range), then
measure the takes with voice_prosody.py measure and listen.
Pauses Between Sections
With flash models: Use SSML break tags inline:
...end of section. <break time="1.5s" /> Start of next...
Max 3 seconds per break. Excessive breaks can cause speed artifacts.
With multilingual_v2 / v3 / v4: No SSML support. Options:
- Paragraph breaks (blank lines) β creates ~0.3-0.5s natural pause
- v3/v4: audio tags such as
[long pause] - Post-process with ffmpeg: split audio and insert silence
WARNING: ... (ellipsis) is NOT a reliable pause β it can be vocalized as a word/sound. Do not use ellipsis as a pause mechanism.
Pronunciation Control
Phonetic spelling (any model): Write words as you want them pronounced:
JanusβJan-usnginxβengine-x- Use dashes, capitals, apostrophes to guide pronunciation
SSML phoneme tags (flash only):
<phoneme alphabet="ipa" ph="ΛdΚeΙͺnΙs">Janus</phoneme>
IPA in v4: no tags needed. Wrap the IPA in slashes and double quotes in place of the word:
The term "/ΛbaΙͺoΚΛkemΙͺstri/" refers to the study of chemical processes.
Iterative Workflow
- Generate β listen β identify pronunciation/pacing issues
- Adjust: phonetic spellings, break tags, voice settings
- Regenerate. If pauses aren't precise enough, add silence in post with ffmpeg rather than fighting the TTS engine.
Speech to Text (Scribe)
with open("voiceover.mp3", "rb") as f:
result = client.speech_to_text.convert(file=f, model_id="scribe_v2", tag_audio_events=False)
words = [w for w in result.words if w.type == "word"] # .text, .start, .end (seconds)
scribe_v2 is current and the toolkit default. scribe_v1 is deprecated, with removal announced for 2026-07-09 (changelog), but still answers, so --stt-model scribe_v1 (redub) and --model scribe_v1 (align_captions) still run it, with a warning. scribe_v1_experimental, a 2025 preview of scribe_v1, is accepted with a warning and sent as scribe_v2. The toolkit uses Scribe in redub.py (transcribe + --sync word timing) and align_captions.py.
Voice Cloning
Instant Voice Clone
with open("sample.mp3", "rb") as f:
voice = client.voices.ivc.create(
name="My Voice",
files=[f],
remove_background_noise=True
)
print(f"Voice ID: {voice.voice_id}")
- Use
client.voices.ivc.create()(notclient.voices.clone()) - Pass file handles in binary mode (
"rb"), not paths - Convert m4a first:
ffmpeg -i input.m4a -codec:a libmp3lame -qscale:a 2 output.mp3 - Multiple samples (2-3 clips) improve accuracy
- Save voice ID for reuse
Professional Voice Clone: Requires Creator plan+, 30+ min audio. See reference.md.
Sound Effects
Max 22 seconds per generation.
result = client.text_to_sound_effects.convert(
text="Thunder rumbling followed by heavy rain",
duration_seconds=10,
prompt_influence=0.3
)
with open("thunder.mp3", "wb") as f:
for chunk in result:
f.write(chunk)
Prompt tips: Be specific β "Heavy footsteps on wooden floorboards, slow and deliberate, with creaking"
Music Generation
10 seconds to 5 minutes. Use client.music.compose() (not .generate()).
result = client.music.compose(
prompt="Upbeat indie rock, catchy guitar riff, energetic drums, travel vlog",
music_length_ms=60000,
force_instrumental=True
)
with open("music.mp3", "wb") as f:
for chunk in result:
f.write(chunk)
Prompt structure: Genre, mood, instruments, tempo, use case. Add "no vocals" or use force_instrumental=True for background music.
Remotion Integration
Complete Workflow: Script to Synchronized Scene
VOICEOVER-SCRIPT.md β voiceover.py β public/audio/ β Remotion composition
β β β β
Scene narration Generate MP3 Audio files <Audio> component
with durations per scene with timing synced to scenes
Step 1: Generate Per-Scene Audio
Use the toolkit's voiceover tool to generate audio for each scene:
# Generate voiceover files for each scene
uv run tools/voiceover.py --scene-dir public/audio/scenes --json
# Output:
# public/audio/scenes/
# βββ scene-01-title.mp3
# βββ scene-02-problem.mp3
# βββ scene-03-solution.mp3
# βββ manifest.json (durations for each file)
The manifest.json contains timing info:
{
"scenes": [
{ "file": "scene-01-title.mp3", "duration": 4.2 },
{ "file": "scene-02-problem.mp3", "duration": 12.8 },
{ "file": "scene-03-solution.mp3", "duration": 15.3 }
],
"totalDuration": 32.3
}
Step 2: Use Audio in Remotion Composition
// src/Composition.tsx
import { Audio, staticFile, Series, useVideoConfig } from 'remotion';
// Import scene components
import { TitleSlide } from './scenes/TitleSlide';
import { ProblemSlide } from './scenes/ProblemSlide';
import { SolutionSlide } from './scenes/SolutionSlide';
// Scene durations (from manifest.json, converted to frames at 30fps)
const SCENE_DURATIONS = {
title: Math.ceil(4.2 * 30), // 126 frames
problem: Math.ceil(12.8 * 30), // 384 frames
solution: Math.ceil(15.3 * 30), // 459 frames
};
export const MainComposition: React.FC = () => {
return (
<>
{/* Scene sequence */}
<Series>
<Series.Sequence durationInFrames={SCENE_DURATIONS.title}>
<TitleSlide />
</Series.Sequence>
<Series.Sequence durationInFrames={SCENE_DURATIONS.problem}>
<ProblemSlide />
</Series.Sequence>
<Series.Sequence durationInFrames={SCENE_DURATIONS.solution}>
<SolutionSlide />
</Series.Sequence>
</Series>
{/* Audio track - plays continuously across all scenes */}
<Audio src={staticFile('audio/voiceover.mp3')} volume=
Truncated for display β read the full file on GitHub.
Related Skills
Agent-Reach
112.7kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu β one CLI, zero API fees.
headroom
79.9kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Scrapling
103.9kπ·οΈ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
crawl4ai
87.5kOfficial Crawl4AI Cloud: a hosted web scraping, extraction, and search API for AI agents. Free API key, 1,000 credits a month, no card. Fully open source: this repo is the Apache-2.0 crawler that powers it, and you can self-host it.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit β see the Safety scan above for what the skill file itself contains.
