skills.rest
roaming-panda-llc
roaming-panda-llcOFFICIAL
Explore all skills by this author →
GitHub

speech

Toggle macOS text-to-speech for Claude responses using file-based flags.

Updated Jan 15, 2026
Search Tags:#automation#accessibility#Claude#text-to-speech#macOS#jq#speech
One-click install
npx skills add https://github.com/roaming-panda-llc/claude-plugins --skill speech
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: speech
Source: https://github.com/roaming-panda-llc/claude-plugins/tree/main/plugins/claude-speech/skills/speech
Command: npx skills add https://github.com/roaming-panda-llc/claude-plugins --skill speech

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This feature eliminates the need to manually read Claude's responses by turning on macOS text-to-speech, improving accessibility and multitasking.

Core Features & Use Cases

  • Toggle via natural language commands (turn on speech, turn off speech)
  • Non-blocking background speech that doesn't interrupt Claude's replies
  • Requires macOS and jq; uses a stop hook to speak when the flag exists or CLAUDE_SPEAK=1 is set
  • Simple file-based control: create or remove ~/.claude-speak to enable/disable speech

Quick Start

Enable Speech: touch ~/.claude-speak Disable Speech: rm -f ~/.claude-speak Check Status: [ -f ~/.claude-speak ] && echo "Speech is ON" || echo "Speech is OFF"

Frequently Asked Questions about speech

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enable text-to-speech for Claude responses on macOS?▼

Enable text-to-speech by creating a file at ~/.claude-speak using the touch command. Claude's stop hook will then use the macOS say command to read responses aloud when the flag exists or CLAUDE_SPEAK=1 is set.

Do I need jq to use macOS text-to-speech with Claude?▼

Yes, jq is required to operate the speech toggle. The skill relies on jq alongside macOS to process the stop hook that triggers the say command for narrating Claude's replies.

How does background speech work without interrupting Claude's replies?▼

Background speech operates non-blocking through a stop hook, meaning it narrates responses aloud without interrupting or delaying Claude's ongoing text generation process.

What is the best way to toggle Claude's spoken responses on and off?▼

Use natural language commands like "turn on speech" or "turn off speech" to toggle the feature. Alternatively, use touch ~/.claude-speak to enable and rm -f ~/.claude-speak to disable.

How do I check if Claude's speech narration is currently active?▼

Check speech status by running [ -f ~/.claude-speak ] && echo "Speech is ON" || echo "Speech is OFF" in the terminal to verify if the flag file exists.

Why is my macOS text-to-speech not working with Claude?▼

macOS text-to-speech requires the ~/.claude-speak flag file or CLAUDE_SPEAK=1 environment variable to be set. Ensure jq is installed and you are running macOS, as the stop hook depends on these to execute the say command.

Related Skills

Explore More Content & Communication Skills→
jason9693jason9693

sherpa-onnx-tts

Synthesize speech from text offline using sherpa-onnx and Piper models.

Community
Intermediate
diegosouzapwdiegosouzapw
44.0k

omniroute-tts

Route text-to-speech requests through OmniRoute to generate spoken audio.

Community
Intermediate
fufuonlinefufuonline

sag

Synthesize local macOS text-to-speech using ElevenLabs voices.

Community
Intermediate
OpenRouterTeamOpenRouterTeam
209

openrouter-tts

Convert written text into speech audio via OpenRouter's TTS API.

Official
Intermediate