tts-notifications

name	tts-notifications
description	Use TTS to speak notifications, alerts, and important messages to the user. Invoke when the user requests audio feedback, task completion announcements, or error notifications that should be spoken aloud.
allowed-tools	["Bash"]

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