Text-to-Speech

Use this skill to speak words or phrases aloud via text-to-speech using the r9s audio API.

Syntax

To speak text, output on its own line:

%{scripts/speak.sh "text to speak"}

Configuration

Set environment variables to customize TTS:

• R9STTSMODEL - TTS model to use (default: tts-1). Examples: tts-1, gpt-4o-mini-tts, speech-2.6-hd
• R9STTSVOICE - Voice to use (default: alloy). Options: alloy, echo, fable, onyx, nova, shimmer
• R9STTSSPEED - Speech speed 0.25-4.0 (default: 1.0)
• R9STTSFORMAT - Audio format (default: mp3). Options: mp3, opus, aac, flac, wav, pcm

Guidelines

• Place the command on its own line, separate from other content
• Use double quotes around the text
• For long narrations, keep text under 4096 characters
• You can use multiple speak commands in one response

Examples

Pronounce a vocabulary word:

**serendipity** /ˌsɛrənˈdɪpɪti/

%{scripts/speak.sh "serendipity"}

**Definition**: The occurrence of pleasant discoveries by chance.

Full narration:

%{scripts/speak.sh "Let's explore the word ephemeral. E-phem-er-al. This beautiful word describes something that lasts for only a very short time."}

Requirements

• r9s CLI installed with valid API key
• Audio player: mpv (recommended), ffplay, afplay (macOS), paplay, or aplay
• Run with --allow-scripts flag to enable script execution