speak

Plays milestone updates aloud with Moodle's built-in text-to-speech engine.

64|19|Updated Mar 23, 2025
One-click install
npx skills add https://github.com/blacktop/mcp-tts --skill speak-blacktop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speak
Source: https://github.com/blacktop/mcp-tts/tree/main/skill
Command: npx skills add https://github.com/blacktop/mcp-tts --skill speak-blacktop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill eliminates the need to manually narrate project milestones by automatically speaking planning outcomes, issues, and summaries using TTS with project-specific voices.

Core Features & Use Cases

  • Project-specific voices: assign separate voices for planning, issues, and summaries.
  • Automatic announcements: triggered after planning completes, issues are resolved, or a summary is generated.
  • Provider orchestration and config: supports provider_order, availability tracking, and a local config at .claude/tts-config.json; auto-assign voices from references/voice-pools.json.
  • Failover and resilience: fallback to macOS say when providers are unavailable.

Quick Start

Configure voices in .claude/tts-config.json and enable automatic announcements after milestones. Then complete a planning, issue, or summary task to hear the Speak skill speak the outcome.

Frequently Asked Questions about speak

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

FAQPage Schema
How do I announce project updates aloud using text-to-speech after a milestone?

To announce project updates aloud, the skill triggers text-to-speech automatically after planning, issue resolution, or summary generation completes, using project-specific voices configured in .claude/tts-config.json.

How does text-to-speech voice assignment work for planning and issue resolution?

Voice assignment works by reading voice pools from references/voice-pools.json and auto-assigning distinct text-to-speech voices for planning, issues, and summaries across multiple projects.

Can I use macOS say as a fallback for TTS when external providers are unavailable?

Yes, macOS say is used as a fallback for TTS announcements when configured providers are unavailable, ensuring audible project feedback continues through provider orchestration failover.

What is the best way to configure TTS provider order and availability for project summaries?

The best way to configure TTS providers is by setting a provider_order and tracking availability in the .claude/tts-config.json file, which manages provider orchestration for project summaries and planning outcomes.

Does this TTS announcement skill require manual triggering after generating a project summary?

No, this TTS announcement skill does not require manual triggering; audible feedback is automatically generated after a project summary, planning phase, or issue resolution completes.

What happens to TTS announcements if my configured voice providers go offline?

If configured voice providers go offline, TTS announcements rely on provider orchestration failover, automatically falling back to the native macOS say command to speak project updates.