🗣️ Edge-TTS Skill using uvx

Text-to-speech conversion using `uvx edge-tts` for generating audio from text. Use when: (1) User requests audio/voice output with the "tts" trigger or keyword. (2) Content needs to be spoken rather than read (multitasking, accessibility, driving, cooking). (3) User wants a specific voice, speed, pitch, or format for TTS output.

Security Scan

The skill is an instruction-only wrapper that tells the agent to call the uvx command-line tool to produce Edge (Microsoft) neural TTS audio; its declared requirements and runtime instructions are coherent and proportionate to that purpose.

Purpose & Capability

Name/description and SKILL.md consistently describe using the 'uvx edge-tts' CLI to generate TTS. The only declared runtime dependency is the uvx binary, which is exactly what the instructions call for.

Instruction Scope

Instructions are limited to invoking uvx with arguments to write media and subtitles to a supplied temp path and to list voices. The SKILL.md does not instruct the agent to read unrelated files, environment variables, or system-wide config. Placeholders ({msg}, {tempdir}, {filename}) are used as expected.

Install Mechanism

There is no install spec (instruction-only), so nothing is downloaded or written by the skill itself. This minimizes installation risk, but it requires the uvx binary to already be present on the host.

Credentials

No environment variables, credentials, or config paths are requested. That aligns with a CLI wrapper that simply calls an existing local binary.

Persistence & Privilege

always is false and the skill has no install or config-writing steps. It does not request elevated or persistent platform privileges.

Assessment

This skill is coherent but requires you to provide and trust the uvx binary. Before installing/using: (1) verify where uvx comes from and install it from the official/trusted source; (2) confirm uvx's runtime behavior — some uvx/edge-tts implementations may launch a browser or use local Edge profile tokens to obtain Microsoft auth, which could interact with your browser profile or network; (3) be aware that Edge neural TTS may send text to Microsoft services, so avoid sending sensitive text if you have privacy concerns; (4) the skill has no homepage or source link, so test in a sandbox first and inspect uvx itself rather than relying on this SKILL.md.

Edge-TTS Skill

Generate high-quality text-to-speech audio using Microsoft Edge's neural TTS service via the node-edge-tts npm package. Supports multiple languages, voices, adjustable speed/pitch, and subtitle generation.

Usage

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3

# With subtitles
uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --write-subtitles -

Changing rate(speed), volume and pitch

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --rate=+50%
uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --volume=+50% --pitch=-50Hz

Changing the voice

uvx edge-tts --text "{msg}" --write-media {tempdir}/{filename}.mp3 --voice=zh-CN-XiaoxiaoNeural

Available voices

Name                               Gender    ContentCategories      VoicePersonalities
en-GB-LibbyNeural                  Female    General                Friendly, Positive
en-GB-RyanNeural                   Male      General                Friendly, Positive
en-GB-SoniaNeural                  Female    General                Friendly, Positive
en-GB-ThomasNeural                 Male      General                Friendly, Positive
en-HK-SamNeural                    Male      General                Friendly, Positive
en-HK-YanNeural                    Female    General                Friendly, Positive
en-US-AnaNeural                    Female    Cartoon, Conversation  Cute
en-US-AndrewMultilingualNeural     Male      Conversation, Copilot  Warm, Confident, Authentic, Honest
en-US-AndrewNeural                 Male      Conversation, Copilot  Warm, Confident, Authentic, Honest
en-US-AriaNeural                   Female    News, Novel            Positive, Confident
en-US-AvaMultilingualNeural        Female    Conversation, Copilot  Expressive, Caring, Pleasant, Friendly
en-US-AvaNeural                    Female    Conversation, Copilot  Expressive, Caring, Pleasant, Friendly
en-US-BrianMultilingualNeural      Male      Conversation, Copilot  Approachable, Casual, Sincere
en-US-BrianNeural                  Male      Conversation, Copilot  Approachable, Casual, Sincere
en-US-ChristopherNeural            Male      News, Novel            Reliable, Authority
en-US-EmmaMultilingualNeural       Female    Conversation, Copilot  Cheerful, Clear, Conversational
en-US-EmmaNeural                   Female    Conversation, Copilot  Cheerful, Clear, Conversational
en-US-EricNeural                   Male      News, Novel            Rational
en-US-GuyNeural                    Male      News, Novel            Passion
en-US-JennyNeural                  Female    General                Friendly, Considerate, Comfort
en-US-MichelleNeural               Female    News, Novel            Friendly, Pleasant
en-US-RogerNeural                  Male      News, Novel            Lively
en-US-SteffanNeural                Male      News, Novel            Rational
fr-FR-DeniseNeural                 Female    General                Friendly, Positive
fr-FR-HenriNeural                  Male      General                Friendly, Positive
zh-CN-XiaoxiaoNeural               Female    News, Novel            Warm
zh-CN-YunjianNeural                Male      Sports,  Novel         Passion
zh-CN-liaoning-XiaobeiNeural       Female    Dialect                Humorous
zh-CN-shaanxi-XiaoniNeural         Female    Dialect                Bright
zh-HK-HiuGaaiNeural                Female    General                Friendly, Positive
zh-HK-WanLungNeural                Male      General                Friendly, Positive
zh-TW-HsiaoChenNeural              Female    General                Friendly, Positive
zh-TW-YunJheNeural                 Male      General                Friendly, Positive\

Retrieve all available voices using shell commands:

uvx edge-tts --list-voices