# add-read-aloud

Builds Grok text-to-speech into an existing app, for read-aloud controls, automatic playback, or spoken page content.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 320 installs · ★ 14099
- Author: cursor
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cursor/plugins/tree/HEAD/grok-voice/skills/add-read-aloud/SKILL.md
- Updated: 2026-10-25
- HTML: https://affpapa.org/en/nevibecode/skills/add-read-aloud

## What it does

The skill guides an agent through adding speech playback for completed assistant replies, narration, or generated audio files. Its default route sends text to Grok TTS from the server and returns an MP3. Keep `XAI_API_KEY` server-side; it must not end up in the browser bundle.

The instructions cover turning formatted text into speech-ready input, handling long messages, and reflecting loading and playback in the app’s controls. Requests are limited to 15,000 characters, so longer text needs splitting or the streaming route. Browser streaming requires a backend relay. Auto-speak should be opt-in and start only after a user gesture.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-read-aloud -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/add-read-aloud/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/add-read-aloud/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-read-aloud -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/add-read-aloud/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-read-aloud -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/add-read-aloud/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cursor/plugins add-read-aloud
```

2. **Manually: put the files in place**
- File: `.github/skills/add-read-aloud/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-read-aloud -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cursor/plugins --path grok-voice/skills/add-read-aloud
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/add-read-aloud/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cursor/plugins --skill add-read-aloud -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cursor/plugins/tree/HEAD/grok-voice/skills/add-read-aloud/SKILL.md

## When to use it
- add a speaker control to completed assistant replies
- narrate page text or create an audio file
- split long input into TTS-sized parts
- keep the Grok API key out of client code

## Example prompts
- Add a control that reads completed assistant replies aloud with Grok TTS.
- Set up page narration and split long text before sending it for speech.
- Make automatic reply playback optional and start it after a user gesture.

## Similar
- [skill-creator](https://affpapa.org/en/nevibecode/skills/skill-creator.md) — skill · 414180 installs
- [writing-for-agents](https://affpapa.org/en/nevibecode/skills/writing-for-agents.md) — skill · 466719 installs
- [media-use](https://affpapa.org/en/nevibecode/skills/media-use.md) — skill · 1100000 installs
- [mcp-builder](https://affpapa.org/en/nevibecode/skills/mcp-builder.md) — skill · 130949 installs
- [subagent-driven-development](https://affpapa.org/en/nevibecode/skills/subagent-driven-development.md) — skill · 237746 installs
- [orchestration](https://affpapa.org/en/nevibecode/skills/orchestration.md) — skill · 349800 installs

From the same set: [cursor/plugins](https://affpapa.org/en/nevibecode/by/cursor/plugins.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md