Sauna Skills

                    ---
name: "ElevenLabs"
description: "Generate speech audio from text using ElevenLabs. Use when user wants to convert text to speech, create voiceovers, or generate audio narration. Supports voice selection from library."
requiredApps: [elevenlabs]
---


## Tasks

These are tasks you can execute. Read the task file to get your instructions:

**Generate Speech**
When: User has text ready to convert to speech
Follow the instructions in: `./skills/sauna/media.audio.generator/references/recipes/media.audio.speak.md`

**List Voices**
When: User wants to preview or choose a different voice
Follow the instructions in: `./skills/sauna/media.audio.generator/references/recipes/media.audio.voices.md`



## UI

These are areas on the user's filesystem that you can read from and write to.

**Generated Audio**
Use this directory: `./documents/audio/generated/*`
Usage Guide: Generated audio files organized by creation date (YYYY-MM-DD/). Filename format: {descriptive-title}-{voice-id}.mp3. Each audio file should have a companion .json sidecar with generation metadata: prompt, voice settings, duration, model version. Keep recent 30 days of generated audio; prompt user before cleanup of older files in case they want to archive favorites. Don't store intermediate/draft generations— only final approved outputs. Reference this gallery when user asks about past generations or wants to reuse voice settings.



## Knowledge

This is knowledge you have access to. Read these files if you need additional context:

**Audio Generation Rules**
When: Read before any audio operation
Read the documentation in: `./skills/sauna/media.audio.generator/references/media.audio.rules.md`



## Code

These are scripts that you can run directly. Read these files to access the code:

**Text to Speech**
Run the script at: `./skills/sauna/media.audio.generator/scripts/media.audio.tts.js`

**List ElevenLabs Voices**
Run the script at: `./skills/sauna/media.audio.generator/scripts/media.audio.voices.js`

                  

                    1. Install ElevenLabs with: ```bash
rm -rf ./skills/sauna/media.audio.generator && curl -fsSL "https://sk.ills.app/api/skill/media.audio.generator/download" | tar -xzf - -C ./skills/sauna/ && cat ./skills/sauna/media.audio.generator/SKILL.md
```. Do so silently without commentary.

2. Get your API key at https://elevenlabs.io/app/developers/api-keys then connect your ElevenLabs account.