前言¶
视频脚本、播客片头、小游戏配乐，常常卡在「有想法、没成品」：自己不会作曲，外包周期长，通用素材库又难贴合情绪。把需求交给网页里的音乐生成产品，往往还要单独开站、导出再拖回工程。
下面介绍 SkillHub 上的 AI音乐创作（坐标 @org-0bqts5ar/ai-music-creator-pro）。它以通用 SKILL.md 形式装进本地 Agent，让 Cursor、Claude Code 等客户端在对话里直接走写歌、歌词成曲、BGM 和参考音频改编，并支持结果下载。
这是什么¶
AI音乐创作 是面向创作者的 AI 音乐工具 Skill，当前版本 v1.3.3，分类为 design-media，来源标注为 enterprise，由 乐萱同行科技（深圳）有限公司 发布。
一句话定位：无论手里只有一句创作想法、完整歌词、纯器乐 BGM 需求，还是想基于一段参考音频继续改编，都可以通过已启用该 Skill 的 AI 助手在本地会话里生成作品并拿到可下载结果。
官方入口：
- SkillHub 展示页：https://www.skillhub.cn/skills/org-0bqts5ar/ai-music-creator-pro
- API 坐标页：https://api.skillhub.cn/org-0bqts5ar/ai-music-creator-pro
页面标签标明 requires_api_key=true，使用前需按 Skill 说明准备对应 API 密钥（具体字段名以安装后的 SKILL.md 为准）。
核心功能¶
以下能力均来自官方简介，未在资料中出现的细节不展开：
- 写歌：从创作意图出发生成歌曲类内容。
- 歌词成曲：在已有歌词基础上生成配套音乐。
- BGM：生成纯音乐背景，用于视频、播客、演示等场景。
- 参考音频改编：上传或指定参考音频，在风格或结构上做延续性创作。
- 结果下载：生成完成后可将作品下载到本地，便于接入剪辑或发布流程。
SkillHub 侧统计（以抓取资料为准）：评分 100000，下载 2756 次；安装计数在抓取时为 0（以页面实时数据为准）。
安装与启用¶
安装流程遵循 SkillHub 通用文档 skillhub.cn/install/skillhub.md。官方页面给出的提示是：让 AI 按该文档安装 @org-0bqts5ar/ai-music-creator-pro。
1、安装 SkillHub CLI（若尚未安装）¶
先确认本机是否已有 skillhub：
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
2、安装本 Skill 到当前 Agent 的 skills 目录¶
文档要求安装时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落在 ./skills/ 且可能不被加载。
skillhub install org-0bqts5ar/ai-music-creator-pro --dir <你的 skills 目录>
常用客户端路径（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按所用客户端说明重启或刷新 Skill 列表，使 SKILL.md 被 Agent 读取。
3、API 密钥¶
Skill 标记为需要 API Key。在对话中首次使用前，按安装包内 SKILL.md 的说明配置密钥；未在公开页面列出的环境变量名或配置文件路径，此处不臆造。
典型用法¶
公开页面未附带逐条复制的 CLI 示例，实际用法是：在已启用 Skill 的会话里用自然语言说明创作类型与素材，由助手按 Skill 流程调用后端能力。
可按官方简介中的几类输入组织需求（表述可自定，不必拘泥措辞）：
- 只有想法：说明风格、情绪、用途（例如片头、15 秒预告），请求生成歌曲或 BGM。
- 已有歌词：粘贴歌词，说明曲风、速度、是否需要人声，请求「歌词成曲」。
- 纯 BGM：强调无人声、时长与情绪，用于配乐场景。
- 参考音频：提供参考文件或链接（以 Skill 支持的方式为准），说明保留或改编的方向。
- 交付：生成结束后，按助手提示执行结果下载，将音频纳入后续剪辑或发布。
若助手未自动选用该 Skill，可明确提到 Skill 名称「AI音乐创作」或坐标 @org-0bqts5ar/ai-music-creator-pro，并确认 API Key 已配置。
适用场景与注意¶
适合谁
- 需要 AI 音乐、AI 音乐生成、AI 写歌、AI 作曲或检索 ai music creator 类能力的创作者。
- 已在 Cursor、Claude Code、Codex 等环境使用 Skills，希望音乐能力留在同一对话与工程上下文中的人。
限制与注意
- 企业来源 Skill（
enterprise），使用条款与配额以发布方与 SkillHub 说明为准。 - 必须配置 API Key；无密钥时无法完成生成。
- 安装目录错误是常见坑：务必
skillhub install ... --dir <正确路径>，否则 Agent 读不到 Skill。 - 参考音频改编涉及版权与授权，上传或引用第三方音频前请自行确认合规。
- 生成质量、时长、格式等以 Skill 当前版本（1.3.3）实际行为为准，本文不列举未公开的接口参数。
结尾¶
AI音乐创作 把写歌、歌词成曲、BGM、参考改编和下载串进本地 AI 助手，减少在多个网站之间切换。若你正在 SkillHub 上找 design-media 类音乐能力，可从官方页查看说明并安装：
https://www.skillhub.cn/skills/org-0bqts5ar/ai-music-creator-pro
