前言¶
在 Cursor、Claude Code 等环境里做内容或产品时，常会需要 BGM、短曲或带歌词的成曲。自己对接 Suno 类音乐 API，要处理鉴权、参数和返回格式，还要在对话里反复说明流程。Suno Skill 把 Suno AI 音乐能力封装成标准 SKILL.md，让 Agent 按技能说明调用，用自然语言描述需求即可。下面介绍它是什么、能做什么，以及如何在 SkillHub 上安装启用。
这是什么¶
Suno（坐标 @org-0bqts5ar/suno-pro，当前版本 1.3.3）是 SkillHub 上的 design-media 类 Skill，来源标注为 enterprise，由 乐萱同行科技（深圳）有限公司 发布。
官方简介将其定位为 Suno AI 音乐入口，面向在 Agent 对话中完成音乐相关任务，而不是单独提供一个桌面客户端。
核心功能¶
以下能力均来自 SkillHub 页面与抓取资料中的简介，未在资料中出现的接口细节不作展开。
- 中文 AI 写歌：用中文描述风格、情绪或主题，由 Agent 按技能指引生成歌曲。
- 歌词成曲：提供歌词后生成对应曲目。
- BGM：生成背景音乐类音频，适合视频、演示等场景。
- 参考音频改编：在提供参考音频的前提下进行改编类生成（具体参数以技能包内说明为准）。
- 歌曲生成：通用的 Suno 歌曲生成入口，与上述场景共用同一 Skill 封装。
Skill 标签包含 requires_api_key=true，使用前需要自行准备 Suno 或技能文档要求的 API 密钥，并在 Agent 环境或技能配置中按说明填写；资料未列出具体环境变量名时，以安装后技能目录内的 SKILL.md 为准。
安装与启用¶
官方安装指引是：先阅读 SkillHub 安装文档，再安装本 Skill。
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-0bqts5ar/suno-pro。
若本机尚未安装 SkillHub CLI，可先检查版本：
command -v skillhub && skillhub --version
未安装时，可按安装文档执行完整安装（含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需要 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装 Suno Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认会装到 ./skills/，Agent 可能无法识别。SkillHub 文档给出的常见路径如下：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令形式为：
skillhub install @org-0bqts5ar/suno-pro --dir <skills 目录>
将 <skills 目录> 替换为你在用的客户端对应路径。安装完成后，按各 Agent 要求刷新或重启，使新 Skill 被加载。
典型用法¶
资料未提供逐条复制的官方示例 prompt；可复现的流程与 SkillHub 安装页一致：
- 完成 CLI 与
@org-0bqts5ar/suno-pro安装，并配置 API Key（见技能内文档）。 - 在已启用 Skills 的对话中，用自然语言说明任务类型，例如：写一首中文流行风歌曲、把给定歌词成曲、生成 30 秒轻快 BGM、基于某段参考音频做改编等。
- 由 Agent 根据
SKILL.md调用 Suno 侧能力，并返回音频或下载方式（以技能实现为准）。
若 Agent 提示缺少密钥或权限，先核对 requires_api_key 相关配置，再查看技能包内说明。
适用场景与注意¶
适合谁：需要在编码或写作环境中顺带产出音乐素材的开发者、独立创作者、做 demo 或短视频配乐的团队；希望少写胶水代码、多靠对话迭代曲风与歌词的场景。
平台信息（SkillHub 抓取）：评分 100000，下载 1877 次，安装计数为 0（以页面统计为准，会随时间变化）。
注意：
- 本 Skill 依赖外部 API Key 与 Suno 服务可用性，费用与配额以服务商条款为准。
- 生成内容的版权与商用范围需自行确认，不宜默认可商用。
- 企业来源 Skill，使用前建议在 SkillHub 上确认版本 1.3.3 与更新说明。
结尾¶
Suno Skill 把 Suno AI 音乐的几类常见需求（中文写歌、歌词成曲、BGM、参考音频改编、歌曲生成）收敛到 Agent 可执行的技能包里，适合已在使用 Cursor、Claude Code、Codex 等并配置了 SkillHub 的工作流。
官方 Skill 地址：https://api.skillhub.cn/org-0bqts5ar/suno-pro
SkillHub 展示页：https://www.skillhub.cn/skills/org-0bqts5ar/suno-pro
