text-to-speech

Converts markdown documents and text to spoken audio using Microsoft Edge TTS neural voices.

Updated Mar 8, 2026
One-click install
npx skills add https://github.com/fabioc-aloha/BrainBenchmark --skill text-to-speech-fabioc-aloha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: text-to-speech
Source: https://github.com/fabioc-aloha/BrainBenchmark/tree/main/.github/skills/text-to-speech
Command: npx skills add https://github.com/fabioc-aloha/BrainBenchmark --skill text-to-speech-fabioc-aloha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires ws, fs-extra.

What problem does it solve? Reading long documents on screen is slow and inaccessible for vision-impaired users or anyone multitasking. This Skill gives the AI assistant a voice, reading markdown files, code, and text aloud with natural neural voices directly inside VS Code. ## Core Features & Use Cases - Document Read-Aloud: Reads the current selection or entire document via keyboard shortcut (Ctrl+Alt+R), with smart markdown stripping that converts headings, tables, symbols, and emojis into natural speech. - Multi-Language Voice Synthesis: Auto-detects 32 languages and selects an appropriate neural voice, with four English voice presets (Default, Warm, British, Friendly). - MP3 Export & Long Content Handling: Saves any document as an MP3 file, chunks long documents with retry logic, and offers LLM-based summarization for content over 5 minutes. - Use Case: A developer proofreads a 30-minute design document by listening during a commute, or a vision-impaired user listens to research papers read aloud with automatic table-to-speech conversion. ## Quick Start Ask the assistant to read the current document aloud, or press Ctrl+Alt+R in VS Code to start playback through the webview audio player.

Frequently Asked Questions about text-to-speech

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

FAQPage Schema
How do I read a document aloud in VS Code?▼

Open any document and press Ctrl+Alt+R (Cmd+Alt+R on macOS), or run the "Alex: Read Aloud" command from the Command Palette. Selected text is read first; otherwise the entire document is read with markdown formatting stripped for natural speech.

What text-to-speech engine works without an API key?▼

Microsoft Edge TTS provides free neural voice synthesis with no API key required. It connects via WebSocket to the Edge read-aloud endpoint and supports over 400 voices across 90+ languages with MP3 output.

Does Edge TTS support languages other than English?▼

Yes, this implementation auto-detects 32 languages using character-based detection for non-Latin scripts like Chinese, Japanese, Arabic, and Russian, plus word-pattern detection for Latin-script languages. It dynamically sets the SSML xml:lang attribute for correct pronunciation.

Why does text-to-speech hang on long documents?▼

Edge TTS stalls on requests over roughly 3000 characters. The solution is chunking text at paragraph or sentence boundaries, synthesizing each chunk with a 60-second timeout, and retrying failed chunks up to three times with exponential backoff.

When should I use cloud TTS instead of Edge TTS?▼

Use cloud TTS services like Replicate models (Chatterbox, Qwen TTS) for audiobook narration, video voiceovers, or voice cloning from a 5-second audio sample. Edge TTS is better for free, instant document reading inside VS Code.