AgentSkillsCN

say

使用r9s音频API进行文本转语音输出

SKILL.md
--- frontmatter
name: say
description: Text-to-speech output using r9s audio API
compatibility: requires r9s CLI with audio API access and audio player (mpv, ffplay, afplay, or paplay)
metadata:
  author: r9s-ai
  version: 2.0.0
  tags: [tts, audio, speech]

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:

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

Configuration

Set environment variables to customize TTS:

  • •R9S_TTS_MODEL - TTS model to use (default: tts-1). Examples: tts-1, gpt-4o-mini-tts, speech-2.6-hd
  • •R9S_TTS_VOICE - Voice to use (default: alloy). Options: alloy, echo, fable, onyx, nova, shimmer
  • •R9S_TTS_SPEED - Speech speed 0.25-4.0 (default: 1.0)
  • •R9S_TTS_FORMAT - 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:

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

%{scripts/speak.sh "serendipity"}

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

Full narration:

code
%{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