快速开始

ListenHub Skills 让 AI 编码工具变成内容创作工具。安装后，只需要用自然语言告诉 AI 想做什么，播客、视频、语音、图片就自动生成了。

整个过程大概 5 分钟。下面一步一步来。

前置条件

开始之前，确认以下三样东西已经准备好：

• ListenHub 账号 + API Key — 在 API Key 设置页面 获取，所有用户均可使用
• curl 和 jq — 这两个命令行工具是 Skills 运行所需的依赖，但大多数情况下 AI 会自动帮你安装，不需要手动操作
• 一个支持 Agent Skills 的 AI 编码工具 — 比如 Claude Code、Cursor、Windsurf、OpenCode 等，任意一个都可以

第一步：安装 Skill

打开终端，运行以下命令。两种安装方式任选其一：

方式一：Vercel skills.sh（推荐）

npx skills add marswaveai/skills

方式二：Open Agent Skills

bunx add-skill marswaveai/skills

安装完成后，Skill 文件会自动添加到当前项目目录中。接下来需要在 AI 编码工具中激活它。

第二步：激活 Skill

打开你的 AI 编码工具（这里以 Claude Code 为例），在对话框中输入：

use listenhub Skill

按回车。你会看到 AI 加载 Skill 并提示"Successfully loaded skill"：

加载成功后，AI 会列出当前可用的四种创作模式，每种模式都有对应的触发词和适用场景：

看到这个界面，说明 Skill 已经激活成功。现在可以开始使用了。

第三步：配置 API Key

第一次使用时，如果还没有配置过 API Key，AI 会自动检测到并弹出配置提示。你会看到类似下面这样的界面：

按照提示操作：

1. 打开 ListenHub API Key 设置页面（需要先登录）
2. 点击创建新的 API Key，或者复制已有的 Key（格式是 lh_sk_ 开头的一串字符）
3. 回到 AI 对话框，直接粘贴 API Key 并回车

AI 会自动保存 Key 并确认配置成功：

配置只需要做这一次。之后每次使用 Skills 都会自动读取已保存的 Key，不需要重复操作。

开始创作

到这里，安装、激活、配置全部完成。现在可以直接用自然语言告诉 AI 你想做什么了。

比如输入"做个播客，聊聊最近的 AI 新闻"，AI 就会自动开始工作。具体的使用案例和操作方式，请参考 基础能力 和 进阶能力 页面。

结果获取与下载

每次创作完成后，AI 会给出在线收听/查看的链接。如果需要下载到本地：

1. 播客和语音：直接对 AI 说"下载音频"，音频文件会自动下载
2. 解说视频：AI 会给出视频的下载链接
3. 图片：默认自动保存到 ~/Downloads 目录
4. 文稿和脚本：在 ListenHub 网站的单集详情页中可以查看

推荐说法

不确定该怎么表达？参考下面这些说法，直接复制修改就能用：

默认行为

如果你没有明确指定某些参数，AI 会按照以下默认规则处理：

1. 语言：自动按输入内容判断中文或英文
2. 播客模式：仅给主题时，默认 quick + 单人
3. 音色：未指定时，自动按语言选择首个可用音色
4. 语音朗读：默认使用 FlowSpeech direct 模式（直接朗读，不修改原文）
5. 多角色对话：脚本中的多角色对话使用 Speech，属于进阶能力

如何上传参考图

图片生成支持"参考图"功能 — 上传一张图片作为风格参考，AI 会基于参考图生成新图片。

操作方式：

1. 打开任意一个公开图床网站，比如 imgbb.com、sm.ms、postimages.org
2. 上传你的参考图片
3. 复制图片的直链地址（通常以 .jpg 或 .png 结尾）
4. 在对话中把链接发给 AI，并描述你想要的效果