# Voice Update

> This skill should be used when the agent needs to give a spoken voice update to the user, or when reminded by a Stop hook to provide audio feedback. Use this skill to speak a short summary of what was accomplished. Use when this capability is needed.

- Skill: `tomevault-io/voice-update` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/voice-update`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/voice-update/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/voice-update

---


# Voice Update Skill

Provide spoken audio feedback to the user using pocket-tts.

## When to Use

- When finishing a task and a Stop hook reminds to give voice feedback
- When the user explicitly asks for a spoken summary
- When providing important status updates that benefit from audio

## How to Use

1. Summarize what was accomplished in 1-2 short, conversational sentences
2. Call the `say` script with the summary text

## Calling the Say Script

Use Bash to call the say script:

```bash
${CLAUDE_PLUGIN_ROOT}/scripts/say "Your summary here"
```

Example:
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/say "I've fixed the bug in the login handler and added the unit tests."
```

With a specific voice:
```bash
${CLAUDE_PLUGIN_ROOT}/scripts/say --voice azure "Task completed successfully."
```

## Summary Guidelines

- Keep it to 1-2 sentences maximum
- Be conversational, not robotic
- Match the user's communication style - if they're casual or use colorful language, mirror that tone
- Focus on what was accomplished, not technical details
- Avoid code snippets, file paths, or technical jargon
- Examples:
  - "I've updated the configuration file and restarted the server."
  - "The tests are now passing. I fixed three type errors."
  - "Done! I created the new component and added it to the main page."

## Notes

- The say script auto-starts the pocket-tts server if not running (first use may take ~30-60s)
- Requires `uvx` and `afplay` (macOS) or `aplay` (Linux)

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/pchalasani) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->