Claude Speak

Documents

claude-speak

Claude Speak is an Agent Skill for documents published in the majiayu000/claude-skill-registry repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Speak text aloud using high-quality AI voice synthesis (Kokoro TTS on Apple Silicon). Use when user asks to vocalize, narrate, or speak text out loud.

View on GitHub ↗

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/majiayu000/claude-skill-registry/blob/HEAD/skills/generation/claude-speak/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/claude-speak, 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.

Claude Speak

Vocalize text using high-quality text-to-speech. British male voice (bm_george) by default.

When to Use

Invoke when user:

Asks to "say this out loud" or "speak this"
Wants narration or audio feedback
Uses /speak command
Requests vocalization of content

Core Command

~/Projects/claude-speak/.venv/bin/claude-speak-client "Text to speak"

That's it. The daemon runs in background via launchd - instant response.

IMPORTANT: When using the Bash tool, set timeout: 300000 (5 min) to avoid Claude Code's default 2-minute timeout on longer text.

Options

# Different voice
~/Projects/claude-speak/.venv/bin/claude-speak-client -v af_heart "Warm female voice"

# Adjust speed (default 1.0)
~/Projects/claude-speak/.venv/bin/claude-speak-client -s 1.2 "Speaking faster"

# Quiet mode (suppress errors)
~/Projects/claude-speak/.venv/bin/claude-speak-client -q "Silent on success"

# Custom timeout (default: 300s / 5 min)
~/Projects/claude-speak/.venv/bin/claude-speak-client -t 600 "Very long text..."

Long Text (3+ sentences)

For longer content, either:

Set longer timeout: Use timeout: 300000 in Bash tool call
Run in background: Use run_in_background: true to avoid blocking

# Background mode - Claude continues while audio plays
~/Projects/claude-speak/.venv/bin/claude-speak-client "Your longer text here..."

Background mode is cleaner for paragraphs and avoids timeout issues entirely.

Available Voices

Voice	Description
`bm_george`	British male, distinguished (DEFAULT)
`af_heart`	American female, warm
`am_adam`	American male, deep
`bf_emma`	British female, elegant

Troubleshooting

If "Daemon not running" error:

~/Projects/claude-speak/.venv/bin/claude-speak-daemon start

Best Practices

Keep utterances concise (1-2 sentences)
Use for key points, not entire responses
Check daemon status if issues arise