elevenlabs
Convert documents and text to audio using ElevenLabs text-to-speech. Use this skill when the user wants to create a podcast, narrate a document, read aloud text, generate audio from a file, or convert text to speech.
Install
npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/elevenlabs
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
git clone https://github.com/sanjay3290/ai-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.
Skill manifest
ElevenLabs - Text-to-Speech & Podcast Skill
Overview
This skill converts text and documents into high-quality audio using ElevenLabs TTS API. It supports two modes: single-voice narration and two-host conversational podcast generation.
When to Use This Skill
Activate when the user mentions:
- "create podcast", "generate podcast", "podcast from document"
- "narrate document", "narrate this file", "read aloud"
- "text to speech", "TTS", "convert to audio"
- "audio from document", "audio version of"
Setup
Config at skills/elevenlabs/config.json:
{
"api_key": "your-elevenlabs-api-key",
"default_voice": "JBFqnCBsd6RMkjVDRZzb",
"default_model": "eleven_multilingual_v2",
"podcast_voice1": "JBFqnCBsd6RMkjVDRZzb",
"podcast_voice2": "EXAVITQu4vr4xnSDxMaL"
}
Only api_key is required. Or set ELEVENLABS_API_KEY env var.
Dependencies: pip install PyPDF2 python-docx (only needed for PDF/DOCX files).
Requires ffmpeg for multi-chunk narration and podcasts.
Commands
List Voices
python skills/elevenlabs/scripts/elevenlabs.py voices
python skills/elevenlabs/scripts/elevenlabs.py voices --json
Use this to find voice IDs for the user.
Single-Voice TTS
# From text
python skills/elevenlabs/scripts/elevenlabs.py tts --text "Hello world" --output ~/Downloads/hello.mp3
# From document
python skills/elevenlabs/scripts/elevenlabs.py tts --file /path/to/doc.pdf --output ~/Downloads/narration.mp3
# With specific voice
python skills/elevenlabs/scripts/elevenlabs.py tts --file doc.md --voice VOICE_ID --output out.mp3
The script handles text extraction, chunking at sentence boundaries (~4000 chars), TTS per chunk with voice continuity, and ffmpeg concatenation automatically.
Podcast Generation
Podcast mode requires a JSON script file with conversation segments:
[
{"speaker": "host1", "text": "Welcome to our podcast! Today we're diving into..."},
{"speaker": "host2", "text": "That's right! I found the section on..."},
{"speaker": "host1", "text": "Let's break that down..."}
]
python skills/elevenlabs/scripts/elevenlabs.py podcast --script /tmp/script.json --voice1 ID1 --voice2 ID2 --output ~/Downloads/podcast.mp3
Podcast Workflow (for Claude)
When the user asks to create a podcast from a document:
Extract the document text:
python skills/elevenlabs/scripts/extract.py /path/to/document.pdfGenerate a two-host conversation script from the extracted text. Follow these guidelines:
- Write as a natural, engaging discussion between two hosts
- Host 1 typically leads/introduces topics, Host 2 adds analysis and reactions
- Start with a brief intro welcoming listeners and stating the topic
- End with a summary/outro
- Keep each turn under 3000 characters
- Vary turn lengths - mix short reactions with longer explanations
- Use conversational language: "That's a great point", "What I found interesting was..."
- Reference specific details from the source document
- Avoid reading the document verbatim - discuss and interpret it
Write the script as a JSON array to a temp file:
# Write to /tmp/podcast_script.json [ {"speaker": "host1", "text": "Welcome to today's episode..."}, {"speaker": "host2", "text": "Thanks for having me..."}, ... ]Generate the podcast:
python skills/elevenlabs/scripts/elevenlabs.py podcast --script /tmp/podcast_script.json --output ~/Downloads/podcast.mp3Clean up the temp script file.
Tips
- Run
voicesfirst to let the user pick voices they like - For podcasts, suggest voice pairs with contrasting qualities (e.g., one deep, one bright)
- Default output to
~/Downloads/unless the user specifies otherwise - For large documents, warn the user about character usage on their ElevenLabs plan
Files (ai-skills)
-
scripts
-
elevenlabs.py 19.8 KB
Loading… -
extract.py 5 KB
Loading…
-
-
config.example.json 224 B
Loading… -
requirements.txt 33 B
Loading… -
SKILL.md 4.2 KB
--- name: elevenlabs description: | Convert documents and text to audio using ElevenLabs text-to-speech. Use this skill when the user wants to create a podcast, narrate a document, read aloud text, generate audio from a file, or convert text to speech. license: Apache-2.0 metadata: author: sanjay3290 version: "1.0" --- # ElevenLabs - Text-to-Speech & Podcast Skill ## Overview This skill converts text and documents into high-quality audio using ElevenLabs TTS API. It supports two modes: single-voice narration and two-host conversational podcast generation. ## When to Use This Skill Activate when the user mentions: - "create podcast", "generate podcast", "podcast from document" - "narrate document", "narrate this file", "read aloud" - "text to speech", "TTS", "convert to audio" - "audio from document", "audio version of" ## Setup Config at `skills/elevenlabs/config.json`: ```json { "api_key": "your-elevenlabs-api-key", "default_voice": "JBFqnCBsd6RMkjVDRZzb", "default_model": "eleven_multilingual_v2", "podcast_voice1": "JBFqnCBsd6RMkjVDRZzb", "podcast_voice2": "EXAVITQu4vr4xnSDxMaL" } ``` Only `api_key` is required. Or set `ELEVENLABS_API_KEY` env var. Dependencies: `pip install PyPDF2 python-docx` (only needed for PDF/DOCX files). Requires `ffmpeg` for multi-chunk narration and podcasts. ## Commands ### List Voices ```bash python skills/elevenlabs/scripts/elevenlabs.py voices python skills/elevenlabs/scripts/elevenlabs.py voices --json ``` Use this to find voice IDs for the user. ### Single-Voice TTS ```bash # From text python skills/elevenlabs/scripts/elevenlabs.py tts --text "Hello world" --output ~/Downloads/hello.mp3 # From document python skills/elevenlabs/scripts/elevenlabs.py tts --file /path/to/doc.pdf --output ~/Downloads/narration.mp3 # With specific voice python skills/elevenlabs/scripts/elevenlabs.py tts --file doc.md --voice VOICE_ID --output out.mp3 ``` The script handles text extraction, chunking at sentence boundaries (~4000 chars), TTS per chunk with voice continuity, and ffmpeg concatenation automatically. ### Podcast Generation Podcast mode requires a JSON script file with conversation segments: ```json [ {"speaker": "host1", "text": "Welcome to our podcast! Today we're diving into..."}, {"speaker": "host2", "text": "That's right! I found the section on..."}, {"speaker": "host1", "text": "Let's break that down..."} ] ``` ```bash python skills/elevenlabs/scripts/elevenlabs.py podcast --script /tmp/script.json --voice1 ID1 --voice2 ID2 --output ~/Downloads/podcast.mp3 ``` ## Podcast Workflow (for Claude) When the user asks to create a podcast from a document: 1. **Extract the document text**: ```bash python skills/elevenlabs/scripts/extract.py /path/to/document.pdf ``` 2. **Generate a two-host conversation script** from the extracted text. Follow these guidelines: - Write as a natural, engaging discussion between two hosts - Host 1 typically leads/introduces topics, Host 2 adds analysis and reactions - Start with a brief intro welcoming listeners and stating the topic - End with a summary/outro - Keep each turn under 3000 characters - Vary turn lengths - mix short reactions with longer explanations - Use conversational language: "That's a great point", "What I found interesting was..." - Reference specific details from the source document - Avoid reading the document verbatim - discuss and interpret it 3. **Write the script** as a JSON array to a temp file: ```python # Write to /tmp/podcast_script.json [ {"speaker": "host1", "text": "Welcome to today's episode..."}, {"speaker": "host2", "text": "Thanks for having me..."}, ... ] ``` 4. **Generate the podcast**: ```bash python skills/elevenlabs/scripts/elevenlabs.py podcast --script /tmp/podcast_script.json --output ~/Downloads/podcast.mp3 ``` 5. **Clean up** the temp script file. ## Tips - Run `voices` first to let the user pick voices they like - For podcasts, suggest voice pairs with contrasting qualities (e.g., one deep, one bright) - Default output to `~/Downloads/` unless the user specifies otherwise - For large documents, warn the user about character usage on their ElevenLabs plan
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.