TTS Notifications Skill

This skill enables Claude to speak text aloud using the Kokoro TTS system.

When to Use

Invoke this skill when:

• User explicitly asks for audio/spoken output
• Task completion notifications would benefit from being spoken
• Error announcements that should grab user attention
• User has indicated preference for audio feedback
• Accessibility needs require spoken feedback

How to Use

Execute the TTS wrapper script to speak a message:

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak "Your message here"

Quick Notification Mode

For non-blocking notifications:

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak -n -b -q "Quick notification"

Options:

• -n, --notification - Optimized for quick notifications (reduced timeout)
• -b, --background - Play in background without blocking
• -q, --quiet - Suppress text output

Voice Selection

Use a specific voice or blend:

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak --voice af_bella "Message"
"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak --voice "af_bella+af_sky" "Blended"

Common Preloaded Messages

These messages are preloaded for instant playback:

• "Build completed successfully"
• "Build failed"
• "Error: Command failed"
• "Tests passed"
• "Tests failed"
• "Task completed"
• "Processing"
• "Warning"

Example Scenarios

Task Completion

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak -n -b "Task completed successfully"

Error Alert

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak "Error: Build failed with 3 errors"

Progress Update

"${CLAUDE_PLUGIN_ROOT}/scripts/tts-wrapper.sh" speak -n -q "Processing step 2 of 5"

Requirements

• Kokoro TTS server must be running on localhost:8880
• uv must be installed for Python dependency management