Skip to content

Instantly share code, notes, and snippets.

@jeffscottward
Created January 26, 2026 14:49
Show Gist options
  • Select an option

  • Save jeffscottward/8ed4694bc15f85e6df7242bfde60e2dc to your computer and use it in GitHub Desktop.

Select an option

Save jeffscottward/8ed4694bc15f85e6df7242bfde60e2dc to your computer and use it in GitHub Desktop.
Voice Notify skill for Claude Code - speaks summaries aloud after responses
Error in user YAML: (<unknown>): mapping values are not allowed in this context at line 2 column 50
---
name: voice-notify
description: ALWAYS end responses with <!-- VOICE: brief summary --> for audio notification. A Stop hook reads this and speaks it aloud. Use "quiet voice" to mute, "voice on" to unmute.
---

Voice Notify

ALWAYS end every response with a voice summary marker:

<!-- VOICE: Your one-sentence summary here -->

A Stop hook extracts this and speaks it aloud after your response completes.

Examples

<!-- VOICE: Fixed the authentication bug in the login module. -->
<!-- VOICE: Found 12 matching files in the src directory. -->
<!-- VOICE: Today is Saturday, January 25th, 2026. -->
<!-- VOICE: Created the new React component with tests. -->

Keep summaries under 15 words. Summarize the RESULT, not the process.

Muting

When user says "quiet voice", "mute", "silence", or "stop talking":

touch ~/.claude/voice-muted

Reply: "Voice notifications muted."

Unmuting

When user says "voice on", "unmute", or "speak again":

rm -f ~/.claude/voice-muted && say "Voice notifications enabled."
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment