voice-update

Speak concise task summaries via pocket-tts after completion or Stop hook requests.

2.0k|126|Updated Jul 30, 2025
One-click install
npx skills add https://github.com/pchalasani/claude-code-tools --skill voice-update
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: voice-update
Source: https://github.com/pchalasani/claude-code-tools/tree/main/plugins/voice/skills/voice-update
Command: npx skills add https://github.com/pchalasani/claude-code-tools --skill voice-update

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables the agent to deliver spoken voice updates to users after tasks complete or when a Stop hook requests an audio recap, summarizing what was accomplished in plain language.

Core Features & Use Cases

  • Spoken status updates: Speak a brief, human-friendly summary of task results after completion.
  • Stop-hook integration: Provide audio feedback automatically when a Stop hook triggers a recap.
  • Voice output via say script: Use pocket-tts-backed speech to convey updates in real time.

Quick Start

Use the voice-update capability to speak a concise summary after a task completes. Example: ${CLAUDE_PLUGIN_ROOT}/scripts/say "I've completed the update task."

Frequently Asked Questions about voice-update

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

FAQPage Schema
How do I get spoken voice updates after a task completes?

To get spoken voice updates after a task completes, you use an audio TTS skill to speak a concise summary of the results. It relies on a say script, an active pocket-tts service, and system audio backends like afplay or aplay to read updates aloud.

How does Stop hook integration work for audio notifications?

Stop hook integration triggers an automatic audio recap when a session or task terminates. The skill uses a say script to generate a task summary and plays it back as a spoken voice update via the pocket-tts service.

Do I need uvx installed to use spoken task summaries?

Yes, you need uvx installed to run spoken task summaries because the audio output depends on an active pocket-tts service. You also need a system audio backend such as afplay on macOS or aplay on Linux.

Can I use text-to-speech notifications on both macOS and Linux?

Yes, you can use text-to-speech notifications on both macOS and Linux. The skill supports system audio playback by utilizing afplay on macOS and aplay on Linux to deliver spoken voice updates.

What is the best way to deliver concise spoken task updates in interactive sessions?

The best way to deliver concise spoken task updates in interactive sessions is using a TTS skill backed by pocket-tts. It generates human-friendly audio summaries and plays them automatically when a Stop hook triggers a recap.

Why are my voice updates not playing after the task finishes?

Voice updates may fail to play if the pocket-tts service is inactive or if uvx is missing. You must ensure a supported system audio backend like afplay or aplay is available to execute the say script properly.