---
name: Voice notes (ElevenLabs)
description: Use to turn text into a natural-sounding audio file with ElevenLabs text-to-speech.
version: 1
situations: text-to-speech, voiceover, audio summary
requires-secrets: ELEVENLABS_API_KEY
requires-packages: elevenlabs
---

# Voice notes with ElevenLabs

This skill needs the **ELEVENLABS_API_KEY** secret and the **elevenlabs** package. The operator sets
the key (write-only) when installing this skill — you never see its value; call it via the engine.

1. Confirm ELEVENLABS_API_KEY is available (use `list_secrets`; if absent, ask the operator to add it).
2. Write the script text to a file in your workspace (files/).
3. Run the elevenlabs synthesis (shell capability) reading the key from the environment the engine
   provides; save the resulting mp3 into files/.
4. Report the file path. If a comms channel is installed, you may attach it via `outgoing_message`.