voice

# Voice — TTS and transcription Set up and test the agent's voice backends. Voice is OPTIONAL — off by default. See `docs/voice.md` for the full reference including channel-plugin precedence. ## Dispatch | User says | Action | |---|---| | `/agent:voice` (no arg) or `/agent:voice status` | Call `voice_status` and print the card | | `/agent:voice setup` | Guided setup (see flow below) | | `/agent:voice test` | Call `voice_speak({ text: "Hola, soy <name>. Esta es una prueba.", ... })` using the user's language, report the path | The agent invokes `voice_speak` / `voice_transcribe` directly when it needs to produce or consume audio during regular conversation. This skill is only for setup and diagnostics. ## Setup flow 1. **Call `voice_status({ format: "json" })`** to see current state. 2. **If no TTS backend is available**, suggest in order of preference: - **sag (recommended):** *"Run `brew install steipete/tap/sag`. It's a small wrapper around ElevenLabs with good voice-prompting conventions."* - **OpenAI TTS:** *"Set `export OPENAI_API_KEY=...` in your shell rc (`~/.zshrc` or `~/.bashrc`). Then restart the agent."* - **macOS `say`:** *"Built in on macOS. Sounds robotic but zero setup. No action needed — will be used as fallback."* 3. **If sag is installed but `ELEVENLABS_API_KEY` is missing**, instruct: *"Get a key from https://elevenlabs.io. Add `export ELEVENLABS_API_KEY=sk_...` to your shell rc. Restart the agent."* 4. **If the user also wants STT**, same lo...