前言¶

做音乐相关的 Agent 能力时，常见做法是让用户自己去客户端里搜歌、翻榜单，再把结果贴回来。对话里一旦涉及「推荐几首」「飙升榜前几名」「我收藏里有没有这首歌」，就需要能对接真实曲库与账号侧数据，而不是凭空编歌名。下面介绍 SkillHub 上的酷狗skill，把搜索、推荐、榜单和收藏等能力接到 Agent 工作流里。

这是什么¶

酷狗skill（坐标 @user_9ce49c06/kugou-skill）是面向酷狗音乐的 Agent Skill，基于通用 SKILL.md 格式，由社区发布者 user_9ce49c06 维护，当前版本为 0.1.20，分类为 life-service，标签标明 requires_api_key=false（无需单独配置 API Key）。

SkillHub 简介将其定位为：在对话中提供歌曲搜索、每日推荐、相似推荐、收藏管理、听歌统计、酷狗榜单、创建歌单等功能，适合需要热门曲目与个性化推荐场景的音乐助手。

核心功能¶

以下能力与 SkillHub 页面简介一致，可按需在对话中触发：

1. 歌曲搜索：按歌名、歌手等条件查找曲目与作品。
2. 每日推荐：获取个性化每日推荐内容（酷狗侧推荐能力）。
3. 相似推荐：围绕当前歌曲或偏好做相似曲目推荐。
4. 收藏管理：查看、整理账号下的收藏。
5. 听歌统计：查看听歌相关统计信息。
6. 酷狗榜单：查询平台榜单（如用户提到的飙升榜、TOP500、抖音热歌等，以技能实际返回为准）。
7. 创建歌单：在账号侧创建或维护歌单。

与其他音乐类 Skill 相比，酷狗音乐侧更侧重推荐与实时更新的榜单数据，适合「要热歌、要猜口味」类需求；具体能力边界以技能包内 SKILL.md 与工具说明为准。

安装与启用¶

官方页面给出的安装方式是通过 SkillHub CLI 安装指定坐标，而不是在正文未核实的其他包名上安装。先做环境检查，再装到当前 Agent 能识别的 skills 目录。

1、安装或确认 SkillHub CLI

若尚未安装，可参考 SkillHub 安装文档（https://skillhub.cn/install/skillhub.md）执行完整安装或仅 CLI：

command -v skillhub && skillhub --version

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

2、安装酷狗skill 到 Agent skills 目录

安装时必须用 --dir 指向当前环境的 skills 目录，否则默认落在 ./skills/，Agent 可能无法加载。SkillHub 文档中 Cursor 对应路径为：

skillhub install @user_9ce49c06/kugou-skill --dir ~/.cursor/skills/

Claude Code、Codex、Windsurf 等客户端路径不同，以同一安装文档第四节为准，将 --dir 换成该客户端的 skills 目录即可。

3、让 Agent 感知技能

页面提示可让 AI 根据 https://skillhub.cn/install/skillhub.md 安装 @user_9ce49c06/kugou-skill。安装完成后按你所用客户端要求刷新或重启，使新技能进入可用列表。

典型用法¶

本技能以自然语言与 Agent 工具调用为主，无单独 REST 示例时，可按对话意图直接描述需求。常见可复现表述如下：

• 「在酷狗里搜一下某某歌手的代表作。」
• 「给我今天的每日推荐 / 相似歌曲。」
• 「看一下酷狗飙升榜或 TOP500 前几首。」
• 「列出我的收藏 / 最近播放 / 听歌统计。」
• 「帮我建一个歌单，名字叫……」

若场景涉及账号（收藏、歌单、统计），技能可能引导登录或身份导入；当环境无法展示扫码图时，可按技能说明向用户提供 base64 secret 等方式完成身份绑定（细节以技能包内文档为准）。若需控制本机酷狗 PC/Mac 客户端播放、暂停、切歌，或涉及 kugou://、mackugou:// 等 URL scheme，应在用户明确提到本机控制或酷狗客户端时再启用对应能力。

适用场景与注意¶

适合在以下任一意图出现时启用本技能：

• 推荐歌曲、听歌建议、相似曲目。
• 搜索歌曲、查歌手作品。
• 查看音乐榜单。
• 查看收藏、最近播放、听歌统计。
• 创建或管理自建歌单。
• 用户提到「酷狗」「kugou」、每日推荐、相似歌曲等关键词。
• 用户提供 base64 secret 要求登录或导入身份；或 Agent 扫码受限时协商 secret。
• 用户要求控制本机酷狗客户端，或提到酷狗 URL scheme、本机控制。

注意：

• 榜单名称与条目以酷狗与技能返回为准，勿假设固定名次或曲目。
• SkillHub 显示评分为 100000，下载 4225（统计随平台更新变化）。
• 社区来源（community）技能，升级与行为变更请关注 SkillHub 上 v0.1.20 及后续版本说明。
• 未在官方页写明的安装命令（例如其他 npm 包名）不要混用；以 @user_9ce49c06/kugou-skill 与 SkillHub 安装文档为准。

结尾¶

酷狗skill 把搜索、每日推荐、相似推荐、榜单、收藏与歌单等能力收敛到一套 Agent Skill 里，适合在对话中完成「找歌—看榜—管库」的闭环。安装与详情见 SkillHub：

• 页面：https://www.skillhub.cn/skills/user_9ce49c06/kugou-skill
• 坐标：@user_9ce49c06/kugou-skill