What problem does this skill solve?

Developers using Claude Code often miss task completion notifications when multitasking or away from the screen. Voice Notify provides real-time TTS (text-to-speech) audio feedback for Claude Code events — task completion, errors, session start — so developers can stay in flow without constantly watching the terminal.

Who uses this workflow?

• macOS developers who use Claude Code for daily coding tasks
• Users running Claude Code agent teams who need audio feedback
• Developers who want a "vibe coding" experience with emotional voice feedback

Features

• 5 emotion presets: celebrate, comfort, encourage, alert, normal
• 3 vibe levels: chill, normal, hype (with filler word injection)
• Auto-triggering via Claude Code hooks: SessionStart, Stop, PostToolUseFailure, Notification
• Bilingual support: Chinese and English
• Time-aware greetings: "Good morning" / "It's late" based on time of day
• Speech queue & debounce: prevents message overlap and spam
• Zero dependencies: uses macOS built-in say + afplay
• One-command install: bash install-hooks.sh auto-configures global hooks

Example usage

# Install the skill
claude /skills add ~/.claude/skills/voice-notify

# Auto-install hooks (one-time setup)
bash ~/.claude/skills/voice-notify/scripts/install-hooks.sh

# Now Claude Code automatically speaks on task completion, errors, etc.

Attribution

Built with macOS native TTS (say) and system sounds (afplay). Filler word injection inspired by NoizAI's characteristic-voice concept.

🤖 Generated with Claude Code