前言¶
在 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
