Voice
Apps & AutomationvoiceVoice is an Agent Skill for apps & automation published in the xvirobotics/metabot repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Convert text to speech audio using the `metabot voice tts` CLI. Use when the user asks you to speak, say something aloud, generate audio, or produce a voice recording.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/xvirobotics/metabot/blob/HEAD/src/skills/voice/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/voice, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Text-to-Speech (Voice Output)
Generate MP3 audio from text using the metabot voice tts CLI.
Quick Commands
# Generate MP3, prints file path to stdout
metabot voice tts "Hello, this is a test"
# Generate and play immediately
metabot voice tts "Hello" --play
# Save to specific file
metabot voice tts "Hello" -o greeting.mp3
# Override provider and voice
metabot voice tts "Hello" --provider doubao --voice zh_female_wanqudashu_moon_bigtts
# Pipe text (useful for long content)
echo "Long text here" | metabot voice tts
echo "Long text" | metabot voice tts -o output.mp3
When to Use
- User asks you to "say", "speak", "read aloud", or "generate audio/voice"
- User wants a voice recording or audio version of text
- User requests TTS (text-to-speech) output
Available Providers & Voices
Edge TTS (default, free, no key needed):
zh-CN-XiaoyiNeural(default) — Female Chinesezh-CN-YunxiNeural— Male Chinesezh-CN-XiaoxiaoNeural— Female Chineseen-US-JennyNeural— Female English
Doubao (default when Volcengine keys configured):
zh_female_wanqudashu_moon_bigtts(default) — Female Chinese- Other Volcengine voice IDs from the TTS console
OpenAI (when OPENAI_API_KEY set):
alloy(default),echo,fable,onyx,nova,shimmer
ElevenLabs (when ELEVENLABS_API_KEY set):
- Voice IDs from the ElevenLabs console
Text Limits
- Doubao: ~300 Chinese characters (longer text is auto-truncated)
- OpenAI / ElevenLabs / Edge: ~4000 characters
Guidelines
- For short text (greetings, alerts), use inline:
metabot voice tts "text" - For longer text, pipe through stdin:
echo "..." | metabot voice tts - The output file is MP3 format
- Use
--playonly when the user explicitly wants to hear the audio (it blocks until playback completes) - When saving files for the user, use
-owith a descriptive filename - To send the audio to the user in Feishu, copy the file to the outputs directory:
cp /tmp/metabot-voice-xxx.mp3 /tmp/metabot-outputs/<chatId>/