前言¶

在 Agent 里做语音相关能力时，常见做法是手写 MCP 配置、自己维护触发词和调用约定。同一套流程要在 Cursor、Codex CLI 等不同客户端里复用，往往还要再抄一份说明给模型读。SkillHub 上的 Voicebox Wrap（@user_922b1001/voicebox-wrap）走的是另一条路：把能力打成符合通用 SKILL.md 规范的社区 Skill，用商店检索和 CLI 安装进各客户端的 skills 目录。下面按已公开的页面与安装包内容说明它是什么、能确认哪些能力，以及怎么装。

这是什么¶

Voicebox Wrap 是 SkillHub 社区源（community）发布的 Skill，坐标 @user_922b1001/voicebox-wrap，当前版本 1.0.0，分类为 design-media，发布者为 user_922b1001。SkillHub 元数据标明 requires_api_key=false，安装本 Skill 本身不需要在 SkillHub 侧配置 API Key。

包内作者字段为 q15004040209-creator，与同发布者的 Ppt Master Wrap 等「Wrap」系列 Skill 同一署名体系；标签为 wrap、github、automation。从名称与 SKILL.md 中仍可读的英文片段（Voicebox AI、SDK、TypeScript）可以判断，它面向 Voicebox 相关能力在 Agent 侧的封装，而不是通用聊天提示词模板。具体业务步骤以你安装后得到的 SKILL.md 为准——当前发布包里的中文描述存在乱码，下文不据此展开未核实细节。

核心功能（已核实部分）¶

依据 SkillHub 页面、CLI 安装结果及包内文件，目前能确认的能力边界如下。

1. Skill 元数据载体：安装后目录中包含 SKILL.md 与 _meta.json，供 Agent 按 Skill 规范加载说明与版本信息（slug: voicebox-wrap，version: 1.0.0）。
2. 无需 SkillHub API Key：标签 requires_api_key=false 表示按官方元数据安装时不必额外提供商店 API Key（与你本地 Voicebox 或其它服务的鉴权无关，后者需按各自产品文档配置）。
3. 通过 SkillHub 分发与更新：可在索引中搜索到，并通过 skillhub install 拉取社区包；SkillHub 列表页展示的评分为 100000，下载 1051 次，安装计数为 0（以抓取时商店数据为准）。

当前 1.0.0 安装包中未包含可执行的脚本、MCP 配置片段或逐步操作示例；若你期望「装完即带完整 TTS/STT 流水线」，需要对照 Voicebox 官方文档，或在 Skill 后续版本补充内容后再核对。

安装与启用¶

1、准备 SkillHub CLI¶

先确认本机是否已有 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装说明执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

更完整的优先源与目录说明见：https://skillhub.cn/install/skillhub.md。

2、安装 Voicebox Wrap¶

安装时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认会装到 ./skills/，客户端可能读不到。SkillHub 搜索结果显示的安装命令为：

skillhub install voicebox-wrap --namespace user_922b1001 --dir <你的 skills 目录>

也可让 Agent 按商店页提示，参照上述 skillhub.md 安装 @user_922b1001/voicebox-wrap。

常见客户端 skills 路径（摘自 SkillHub 安装文档，按你实际环境选用）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

安装完成后重启或重新加载对应客户端，使新 Skill 进入会话上下文。

3、让 Agent 读取 Skill¶

SkillHub 商品页提供的做法是：将「请根据 https://skillhub.cn/install/skillhub.md，安装 @user_922b1001/voicebox-wrap」类提示发给 AI，由 Agent 按文档完成安装与目录校验。你本地已安装时，只需保证 skills 目录正确且客户端已识别即可。

典型用法¶

官方可复现的用法目前集中在发现与安装，没有随包附带的命令行演示或代码片段。

1. 在 SkillHub 打开技能页：https://www.skillhub.cn/skills/user_922b1001/voicebox-wrap（或 https://skillhub.cn/skills/user_922b1001/voicebox-wrap）。
2. 使用 skillhub search voicebox 确认坐标与版本（当前为 1.0.0）。
3. 执行上一节的 skillhub install，并在目标 Agent 中发起与 Voicebox / 语音自动化相关的任务，由模型依据加载后的 SKILL.md 作答。

若 SKILL.md 中的 Description 在你本地仍显示为问号乱码，建议先到 SkillHub 技能页查看是否有更新版本，或向发布者反馈编码问题，避免 Agent 误解技能范围。

适用场景与注意¶

更适合谁

• 已在用或计划用 Voicebox 生态，希望把相关约定收敛成一个可安装的 Agent Skill，而不是每次手写长提示。
• 习惯通过 SkillHub 管理 skills，并需要在 Cursor、Claude Code、Codex 等多端共用同一套 SKILL.md。

限制与注意

• 当前包体极简，核心价值是标准化分发与元数据；具体对接 Voicebox SDK、TypeScript 侧实现需以修复后的 SKILL.md 或后续版本为准。
• design-media 分类表明其偏设计与媒体工作流；是否与你的合规、离线推理要求一致，需结合 Voicebox 本身部署方式自行评估。
• 商店 API 地址 https://api.skillhub.cn/user_922b1001/voicebox-wrap 在浏览器直接访问可能返回 405；安装与检索以 skillhub CLI 与 Web 技能页为准。

结尾¶

Voicebox Wrap 把 Voicebox 相关能力以社区 Skill 的形式挂在 SkillHub 上，便于搜索、安装和跨客户端复用 SKILL.md；安装侧无需 SkillHub API Key，当前版本以元数据封装为主。使用前建议核对本地 SKILL.md 是否完整可读。

官方入口：

• SkillHub 技能页：https://www.skillhub.cn/skills/user_922b1001/voicebox-wrap
• API 坐标页：https://api.skillhub.cn/user_922b1001/voicebox-wrap