How do I install the Read Aloud skill?

Run npx skillmds@latest add richawo/read-aloud in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Read Aloud safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Read Aloud?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Read Aloud free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Read Aloud?

richawo (@richawo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Read Aloud by richawo — Agent Skill

Name: Read Aloud
Author: richawo

Read Aloud

Read text or a text file aloud as a local WAV through the existing Yaps MCP speech tools. Use for text-to-speech, narration, voice-over, or speaking English or other supported languages with a Yaps voice. Do not use for transcribing media or live dictation.

richawo 81d4d0a 1.5 KB Updated Sep 17, 2026

File contents

Yaps Read-aloud

Use the existing Yaps MCP tools. Do not invent shell commands, PATH edits, or a second CLI.

Tools

yaps_status — call first when any other Yaps tool reports a problem.
tts_voices — list installed reading engines and voice ids before synthesizing.
text_to_speech — synthesize text or a text file to a local WAV (or raw PCM only if requested). Prefer text_file for long or multiline text. Pass language for non-English text so Supertonic is used.
yaps_enable_feature — only after the user explicitly asks to install a reading voice.

Reachability

This plugin is local-only and requires the installed Yaps desktop app. If tools return local_yaps_unreachable, cli_missing, or equivalent, the current Cursor session cannot see the Yaps engine on this computer. Do not claim Yaps is uninstalled. Offer Download Yaps, ask the user to open the app on this machine, and retry from a local Cursor session.

Boundaries

Do not silently send the text to an unrelated hosted speech service.
Preserve the user's text; do not rewrite the script unless requested.
Never replace an existing output file without explicit approval.
Use the transcribe or dictation skills for speech-to-text.

Frequently asked questions