Elevenlabs

This converts documents and text to audio using ElevenLabs TTS, with two modes: single-voice narration and two-host podcast generation. The podcast workflow is the standout feature. It extracts text from PDFs or docs, lets you generate a conversational script as JSON (with speaker turns), then synthesizes it with two different voices. Handles chunking and concatenation automatically via ffmpeg. You can also just narrate a document straight with one voice. Requires an ElevenLabs API key and works best if you list available voices first so users can pick what they want. Good for turning written content into listenable audio without manual recording.

skills.sh installs: 362
GitHub stars: 454
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add sanjay3290/ai-skills --skill elevenlabs --agent claude-code

Installs into .claude/skills of the current project.

Files

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

SKILL.md on GitHub

Details

Repository: github.com/sanjay3290/ai-skills
Categories: AI & Agent Building, Generative Media, Video & Audio Editing
License: Apache-2.0
First seen: Jun 3, 2026