mcpField
L
listenhub

listenhub

github.com/marswaveaiCreative & media811.5k installsUpdated 5w ago
Repository

About listenhub

listenhub is a routing skill for ListenHub actions. It identifies the user’s intent and directs requests to a specialized skill, asking for clarification when the request is ambiguous.

Key features

  1. 01Intent-based routing to specialized skills
  2. 02Keyword-based request categories
  3. 03Clarification for ambiguous requests
  4. 04CLI authentication and setup guidance

Use cases

  1. 01Direct a general ListenHub request to the matching skill
  2. 02Clarify which creation workflow to use when intent is unclear

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/marswaveai/skills --skill listenhub

After installing, type/listenhubin Claude Code to confirm it loaded.

Details

From the project README

Purpose

This is a router skill. When users trigger a general ListenHub action, this skill identifies the intent and delegates to the appropriate specialized skill.

Routing Table

User intentKeywordsRoute to
ListenHub Voice end-to-end audio"端到端音频", "语音生成", "图片转音频", "图片生成音频", "多音色对白", "参考音频克隆", "克隆音色", "音效", "生成音效"/listenhub-voice
Podcast"podcast", "播客", "debate", "dialogue"/podcast
Explainer video"explainer", "解说视频", "tutorial video"/explainer
Slides / PPT"slides", "幻灯片", "PPT", "presentation"/slides
Voice cloning (persistent)"克隆我的声音", "克隆音色", "声音克隆", "语音克隆", "用我的声音", "自定义音色", "clone my voice", "custom voice"/voice-clone
TTS / Read aloud"TTS", "read aloud", "朗读", "配音", "语音合成"/tts
Image generation"generate image", "画一张", "生成图片", "AI图"/image-gen
Video generation"video", "视频", "seedance", "pixverse", "生成视频", "text to video", "做视频", "口型", "lipsync", "对口型"/video-gen
Music"music", "音乐", "生成音乐", "翻唱", "混音", "remix", "续写", "extend", "纯音乐", "instrumental", "配乐", "soundtrack", "分轨", "stem", "识别歌词", "克隆人声", "vocal clone"/music
Content extraction"parse URL", "extract content", "解析链接"/content-parser
Audio transcription"transcribe", "ASR", "语音转文字"/asr
Creator workflow"创作", "写公众号", "小红书", "口播"/creator

How to Route

  1. Read the user's message and identify which category it falls into
  2. Tell the user which skill you're routing to
  3. Follow that skill's SKILL.md completely

If the intent is ambiguous, ask the user to clarify:

Question: "What would you like to create?"
Options:
  - "ListenHub Voice" — End-to-end audio: sound effects, multi-voice dialogue, reference-audio cloning, image→audio
  - "Voice Cloning" — Clone your own voice into a reusable speaker
  - "Podcast" — Audio discussion on a topic
  - "Explainer Video" — Narrated video with AI visuals
  - "Slides" — Slide deck / presentation
  - "Music" — AI music: generate, remix, instrumental, soundtrack, stem, vocal clone
  - "Video" — AI video generation from text or reference materials

Prerequisites

Most skills require the ListenHub CLI. Check:

listenhub auth status --json

If not installed or not logged in, handle automatically — never ask the user to run install commands:

  1. Auto-install: run npm install -g @marswave/listenhub-cli silently
  2. Auto-login: run listenhub auth login (opens browser)

Exception: /asr runs locally and needs no CLI or API key.

Comments

Markdown supported