| name | voice-integration |
| description | This skill should be used when the user asks about "[VOICE] tag", "voice notification",
"TTS settings", "speech rate", "voice language", "text-to-speech", or mentions CVI configuration.
Also use this skill when completing tasks to provide voice notification summaries.
|
| version | 1.0.0 |
Voice Integration Guide
This skill provides guidance on using CVI (Claude Voice Integration) for voice notifications in Claude Code.
MANDATORY: Task Completion Pattern
Every task completion MUST follow this exact pattern:
[detailed task explanation...]
<use Skill tool: skill="cvi:speak" args="2-3 sentences explaining what was done">
CRITICAL: Use Skill tool, NOT text
- ❌ Do NOT write
/cvi:speak xxx as text
- ✅ Use Skill tool with
skill="cvi:speak" and args="your message"
- ❌ Do NOT use [VOICE] tag - it's deprecated
Why Skill tool only (no [VOICE] tag)?
- The Skill result (
Speaking: ...) serves as the visible summary
- Single source of truth - no duplication or mismatch
- Skill tool
/cvi:speak: Triggers macOS notification + Glass sound + voice
If you forget to use Skill tool:
- ❌ Stop hook will BLOCK your stop request
- ❌ No voice notification will play
- ❌ User will not hear task completion
Language Configuration
The summary language is controlled by VOICE_LANG in :
