Elevenlabs Pro

ElevenLabs advanced TTS for converting text to speech, listing voices, and managing credits

Security Scan

The skill's code and documentation require an ElevenLabs API key and perform expected TTS calls, but the registry metadata does not declare the required credential — this mismatch and the unknown source mean you should proceed cautiously.

Purpose & Capability

The SKILL.md and scripts/elevenlabs.py implement ElevenLabs TTS, voice listing, and credit checks and call https://api.elevenlabs.io/v1 — this matches the skill name/description.

Instruction Scope

Runtime instructions limit actions to using the ElevenLabs API, listing voices, generating audio files, and querying subscription/credits. The instructions do not request unrelated files, system credentials, or external endpoints beyond api.elevenlabs.io.

Install Mechanism

No install spec is provided (instruction + code only). There are no downloads or archive extraction steps; risk from the install mechanism is low.

Credentials

The SKILL.md and scripts require an ELEVENLABS_API_KEY (or --api-key) but the registry metadata lists no required environment variables or primary credential. That mismatch is an incoherence: the skill will fail without the API key and the registry did not declare it as a required credential. No other unrelated secrets are requested.

Persistence & Privilege

The skill is not always-enabled and does not request elevated agent/system persistence. It does write MP3 output to the filesystem (user-specified path), which is appropriate for its purpose.

What to consider before installing

This skill does what it says (calls ElevenLabs API and writes audio files), but the registry metadata omits the required ELEVENLABS_API_KEY credential even though both SKILL.md and the included Python script require it. Because the package source is 'unknown', verify the origin before installing. If you install: (1) only provide a minimal-scope ElevenLabs API key (rotate it if compromised), (2) run the script in an isolated environment or container, (3) inspect the included scripts yourself (you already have them) and confirm network calls go only to api.elevenlabs.io, and (4) avoid pasting high-privilege credentials into third-party skills from unknown publishers. If you need higher assurance, ask the publisher to declare the required env var in the registry and provide a trusted homepage or source repository.

ElevenLabs Pro Skill

Advanced text-to-speech using the ElevenLabs API. Supports voice selection, language/gender filtering, audio file generation, and credit tracking.

Prerequisites

Set your API key as an environment variable:

export ELEVENLABS_API_KEY=sk_...

Or pass it directly with --api-key.

Usage

Convert text to speech

python3 scripts/elevenlabs.py "Hello world" --voice Sarah --output audio.mp3

List available voices

python3 scripts/elevenlabs.py --list-voices
python3 scripts/elevenlabs.py --list-voices --lang en --gender female
python3 scripts/elevenlabs.py --list-voices --json

Check remaining credits

python3 scripts/elevenlabs.py --credits

Options

Option	Default	Description
--voice NAME	Rachel	Voice name (partial match supported)
--voice-id ID	—	Direct voice ID (overrides --voice)
--output PATH	output.mp3	Output MP3 file path
--model ID	eleven_turbo_v2_5	Model ID
--stability	0.5	Voice stability (0–1)
--similarity	0.75	Similarity boost (0–1)
--style	0.0	Style exaggeration (0–1)
--lang CODE	—	Filter voices by language (e.g. en, fr)
--gender	—	Filter voices by gender (male/female)
--json	—	Output as JSON
--api-key KEY	—	API key (overrides env var)

Available Models

Model ID	Description
eleven_turbo_v2_5	Fastest, lowest latency (free tier supported)
eleven_multilingual_v2	Best quality, multilingual
eleven_flash_v2_5	Ultra-low latency

Importable API

import sys
sys.path.insert(0, "path/to/skills/elevenlabs-pro/scripts")
from elevenlabs import list_voices, get_voice_id, text_to_speech, get_credits

api_key = "sk_..."
# TTS
voice_id = get_voice_id(api_key, "Sarah")
path = text_to_speech(api_key, "Hello!", voice_id, "out.mp3")

# Credits
info = get_credits(api_key)
print(info["characters_remaining"])

References

See references/voices.md for popular voices and voice parameter guidance.