tts

Announce discoveries, completions, errors, and milestones via macOS Text-to-Speech.

Updated Nov 20, 2025
One-click install
npx skills add https://github.com/ianpojman/claude-skills --skill tts
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tts
Source: https://github.com/ianpojman/claude-skills/tree/main/tts
Command: npx skills add https://github.com/ianpojman/claude-skills --skill tts

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Developers often miss critical alerts, errors, or key findings buried in logs or terminal output, especially when multitasking or away from the screen. This Skill ensures important information is audibly announced, keeping you informed without constant visual monitoring.

Core Features & Use Cases

  • Audible Alerts: Get spoken announcements for discoveries, completions, errors, and milestones using a premium macOS voice.
  • Pause/Resume: Easily pause announcements for calls or meetings with a simple command.
  • Sequential Audio: Ensures announcements play one after another, preventing overlapping audio.
  • Use Case: Integrate into your build scripts to hear "Build succeeded. All tests passed" or "Build failed. Three compilation errors found" without constantly checking your terminal, allowing you to focus on other tasks.

Quick Start

Use the tts skill to announce "Your build is complete. All tests passed."

Frequently Asked Questions about tts

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

FAQPage Schema
How do I automate voice alerts for build completions and errors?

Text-to-speech automation announces build outcomes, test results, and errors aloud using macOS system voices. Integrate the tts Skill into your build scripts to hear spoken summaries like "Build succeeded. All tests passed" without checking your terminal.

Can I use text-to-speech alerts in CI/CD pipelines?

Yes. The tts Skill delivers audible announcements for discoveries, completions, errors, and milestones in CI/CD workflows, monitoring systems, and test suites. Plays system sounds followed by spoken messages to notify you of pipeline events in real time.

How do I pause or mute text-to-speech announcements?

Text-to-speech provides pause/resume control via a ~/.tts_paused flag, letting you suppress announcements during calls or meetings. Toggle the flag to temporarily silence audible alerts without removing the Skill from your workflow.

What's the best way to get audio alerts for long-running tasks?

Audible announcements keep you informed during extended processes without constant screen monitoring. The tts Skill plays sequential audio for task milestones, ensuring no overlapping messages and letting you focus on other work while waiting for completion.

Does text-to-speech work with macOS notifications and monitoring workflows?

Yes. The tts Skill integrates into macOS environments, monitoring systems, and notification workflows by combining afplay system sounds with the say command for customizable voice delivery across different notification types.