tts

Converts text into speech audio via the ListenHub CLI with single-voice and multi-speaker modes.

335|37|Updated Jul 18, 2026
One-click install
npx skills add https://github.com/joeseesun/qiaomu-cut-skill --skill tts-joeseesun
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: tts
Source: https://github.com/joeseesun/qiaomu-cut-skill/tree/main/vendor/marswaveai-skills/tts
Command: npx skills add https://github.com/joeseesun/qiaomu-cut-skill --skill tts-joeseesun

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Turning written text into natural-sounding spoken audio normally requires picking a TTS service, choosing voices, handling authentication, and managing output files. This Skill wraps the ListenHub CLI into a guided workflow that converts text to speech with sensible voice defaults and persistent user preferences. ## Core Features & Use Cases - Quick Mode: Single-voice, low-latency synchronous speech generation for reading snippets, notifications, or casual text aloud. - Script Mode: Multi-speaker generation with per-character voice assignment for dialogue, audiobooks, and scripted narration, including subtitles and duration metadata. - Voice & Config Persistence: Saves default speakers per language and output mode (inline link or downloaded MP3) to a local config file so repeat runs need no setup. - Use Case: Ask the agent to create a two-person Chinese dialogue voiceover; it parses the script, assigns default voices, submits the job, polls until complete, and saves a topic-named MP3 to the working directory. ## Quick Start Ask the agent to read a piece of text aloud or generate a multi-character dialogue voiceover, and confirm the proposed voice and text before generation.

Frequently Asked Questions about tts

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

FAQPage Schema
How do I convert text to speech with the ListenHub CLI?▼

Run listenhub tts create with the text, a speaker name, language, and --mode direct for single-voice output. The command returns a JSON result containing an audioUrl you can play or download as an MP3.

How do I generate multi-speaker dialogue audio from a script?▼

Use script mode by passing --mode smart with one --speaker flag per character and the script text formatted as SpeakerName: line. The job runs asynchronously, so submit with --no-wait and poll listenhub creation get until the status is completed.

What is the difference between direct mode and smart mode in TTS?▼

Direct mode generates single-voice audio synchronously for short plain text. Smart mode handles multi-speaker scripts with per-segment voice assignment, runs asynchronously, and returns audioUrl, subtitlesUrl, duration, and credit usage.

Does the ListenHub TTS CLI require authentication?▼

Yes. OpenAPI routing reads a key from the LISTENHUB_API_KEY environment variable or local credential store and uses listenhub openapi tts commands. OAuth routing requires running listenhub auth login and uses top-level listenhub tts commands.

Can I save a default voice so I do not pick one every time?▼

Yes. Selected voices are stored per language in .listenhub/tts/config.json under defaultSpeakers. On later runs the saved voice is used silently unless you explicitly ask to change it.

When should I not use this TTS skill?▼

Avoid it for podcast-style topic discussions, which belong to a podcast skill, and for explainer videos with visuals, which belong to an explainer skill. It is focused purely on converting provided text or scripts into speech audio.