#123 by GitHub stars
multimodal-art-projection/YuE
YuE2: frontier music generation with symbolic planning, zero-shot covers, and agentic music editing.
History
Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.
View weekly changes
skills/yue2-music/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
55668d6b0021 → 1116bea76032
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 55668d6b0021
No earlier version was observed for comparison.
skills/yue2-music/instrumental/SKILL.md
Week of Nov 2, 2026 · +0 / −0 lines
Before Network or broad shell → After Network or broad shell
55668d6b0021 → 1116bea76032
Week of Oct 26, 2026 · Line counts unavailable
Before Not checked yet → After Network or broad shell
First observation → 55668d6b0021
No earlier version was observed for comparison.
Heat
7.5- Star growth, last 7 daysAhead of 89% of tracked repositories
- Star growth, last 24 hoursAhead of 86% of tracked repositories
- Rank movement, last 7 daysAhead of 78% of tracked repositories
- Commits, last 30 daysAhead of 88% of tracked repositories
- Accounts asking about it through MCP, last 7 daysNot available
- Hot votes this weekAhead of 0% of tracked repositories
Heat never changes the order by stars, and sponsorship never touches it. How heat works
Stars over time
Individual skills in this repository
- yue2-music
skills/yue2-music - yue2-instrumental
skills/yue2-music/instrumental
How it works
yue2-music
When your agent uses it
Generate instrumental music and songs, cover, transcribe, and edit with YuE2 and SheetSage2/MERT2. Use for text-to-instrumental generation, instrumental covers, YuE2 full/melody/off generation, audio-to-ABC covers, style or lyric changes, score editing, agentic reharmonization, melody preservation, singable lyric adaptation, and reproducible listening comparisons; also for YuE2 纯音乐生成、器乐翻奏、翻唱、改编、改谱、换词和智能体编辑.
What it loads into context
Frontmatter
123 tokensAlways available to the agent
SKILL.md
2,138 tokensWhen the skill is activated
Reference documents
13,990 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- Instrumental generation and covers
- Choose the workflow
- Set up the needed models
- Generate and retain the plan
- Cover a recording
- Edit or delegate an edit
- Deliver an audible result
Scripts executed separately
scripts/abc_tools.pyscripts/common.pyscripts/listen.pyscripts/run_yue2.pyscripts/transcribe.py
Files
LICENSEasset11,358 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesSKILL.mdcore9,585 bytesagents/openai.yamlasset325 bytesassets/edit-brief.mddoc1,563 bytesassets/prompt.jsonasset498 bytesreferences/abc-editing.mddoc12,858 bytesreferences/editing-workflows.mddoc9,514 bytesreferences/generation-and-covers.mddoc12,533 bytesreferences/listening-and-evaluation.mddoc8,143 bytesreferences/models-and-setup.mddoc17,287 bytesscripts/abc_tools.pyruns15,750 bytesscripts/common.pyruns951 bytesscripts/listen.pyruns14,820 bytesscripts/run_yue2.pyruns10,401 bytesscripts/transcribe.pyruns6,126 bytes
Read SKILL.md
# YuE2 Music
Turn a musical request into a reproducible song and an audible comparison. Use released
model interfaces. Retain an original song and its plan before making changes.
Recommended agent: **GPT-6 Astra**. YuE2 composes the default score and renders the audio;
the agent operates the workflow and checks the results.
## Instrumental generation and covers
For instrumental, no-vocals, or 纯音乐 requests, follow
[instrumental/SKILL.md](instrumental/SKILL.md). A simple style description is enough.
Default to YuE2 planning, move every Vocal note to Ins, and render the revised score.
Only write a new score with the agent when the user explicitly asks for agent composition.View the complete source on GitHubyue2-instrumental
When your agent uses it
用 YuE2 生成纯音乐或制作纯音乐 cover。默认由 YuE2 写谱,自动将 Vocal 音符移到 Ins 后生成;只有用户明确要求 agent 作曲时才由 agent 写谱。支持文字描述、ABC 或音频参考,交付试听、真实 prompt 和转谱检查。
What it loads into context
Frontmatter
80 tokensAlways available to the agent
SKILL.md
1,152 tokensWhen the skill is activated
Reference documents
5,867 tokensLoaded on request
Token counts are estimates. Scripts run separately; they are not counted as reference context.
The playbook
- 选择来源
- 一条命令
- 转谱规则
- 输出
Scripts executed separately
scripts/abc_tools.pyscripts/common.pyscripts/compile_score.pyscripts/instrumental.pyscripts/instrumentalize.pyscripts/setup_runtime.pyscripts/test_tools.pyscripts/transcribe_cover.pyscripts/verify_bundle.py
Files
LICENSEasset1,080 bytesPRIVACY.mddoc2,381 bytesREADME.mddoc2,889 bytesSKILL.mdcore4,291 bytesSKILL.mdcore4,291 bytesagents/openai.yamlasset312 bytesassets/cover-release.jsonasset603 bytesassets/example-ins.abcasset305 bytesassets/example-original.abcasset314 bytesassets/example-repairs.jsonasset772 bytesassets/example-style.txtdoc269 bytesassets/release.jsonasset2,151 bytesassets/validation.jsonasset8,698 bytesbundle-manifest.jsonasset3,768 bytesreferences/abc-repair.mddoc5,123 bytesreferences/cover.mddoc2,783 bytesreferences/event-schema.mddoc1,780 bytesreferences/setup.mddoc5,128 bytesrequirements-inference.txtdoc192 bytesscripts/abc_tools.pyruns15,750 bytesscripts/common.pyruns951 bytesscripts/compile_score.pyruns10,540 bytesscripts/instrumental.pyruns27,768 bytesscripts/instrumentalize.pyruns5,980 bytesscripts/setup_runtime.pyruns5,991 bytesscripts/test_tools.pyruns27,776 bytesscripts/transcribe_cover.pyruns6,300 bytesscripts/verify_bundle.pyruns2,338 bytes
Read SKILL.md
# YuE2 纯音乐与器乐 cover
用户只需描述音乐或提供参考。你负责环境、转谱、运行和交付;用户不需要懂声部格式或推理参数。
推荐使用 GPT-6 Astra 作为执行本 skill 的 agent;默认作曲与声音生成仍由 YuE2 完成。
## 选择来源
- **文字生成,默认模式**:调用 YuE2 的符号规划器写谱,保存原谱,将 Vocal 旋律移到 Ins 后重新生成音频。不要自己写 events/ABC 替代这一步,也不要套用示例旋律。
- **用户明确要求 agent 作曲**:才由你写谱,使用 `--composer agent`。复杂谱可以写 [events.json](references/event-schema.md)。
- **用户给了 ABC**:以用户曲谱为准,直接转为纯音乐条件,不重新作曲。只有不规范输入才读 [修谱规则](references/abc-repair.md);保留原件与改动说明。
- **纯音乐 cover**:读 [cover 流程](references/cover.md)。音频先经 SheetSage2 转谱,再做相同的 Vocal → Ins 转换。默认保留旋律、让 YuE2 重新配伴奏;要求保留原和声时加 `--keep-harmony`。这不是直接去人声或伴奏分离。
模型规划失败或曲谱无法解析时保留原始输出,定位问题后至多重试一次。不要自动切换成 agent 作曲;音乐性修改必须符合用户授权。严格时长和音频逐音跟谱不是模型保证。View the complete source on GitHubSkills included
- yue2-music
- yue2-instrumental
Repository facts
- License
- Apache-2.0
- Created
- Jan 23, 2025
- Last pushed
- Nov 1, 2026
- Forks
- 1,516
- Open issues
- 32
- Project activity
- Active
Rank over the last 12 weeks
Now #123 · best #121 · up 5 in 30 days
- #122 on Oct 30
- #123 on Oct 31
- #122 from Nov 1 to Nov 2
- #123 on Nov 3
- #121 from Nov 4 to Nov 6
- #123 since Nov 7
56 earlier periods
- #163 on Aug 2
- #164 on Aug 8
- #165 on Aug 9
- #169 from Aug 10 to Aug 11
- #170 on Aug 13
- #171 from Aug 14 to Aug 15
- #172 on Aug 16
- #173 on Aug 17
- #175 from Aug 18 to Aug 19
- #174 on Aug 21
- #170 on Aug 22
- #176 on Aug 23
- #175 on Aug 25
- #176 on Aug 26
- #179 on Aug 27
- #177 on Aug 28
- #179 on Aug 29
- #178 from Aug 30 to Aug 31
- #183 on Sep 1
- #179 on Sep 2
- #185 on Sep 3
- #184 on Sep 5
- #181 on Sep 6
- #184 on Sep 7
- #185 on Sep 8
- #186 on Sep 9
- #178 on Sep 10
- #170 on Sep 11
- #164 on Sep 12
- #158 on Sep 13
- #148 on Sep 14
- #142 on Sep 15
- #136 on Sep 16
- #134 from Sep 17 to Sep 18
- #133 from Sep 19 to Sep 23
- #131 on Sep 24
- #132 on Sep 25
- #130 on Sep 26
- #129 on Sep 27
- #130 from Sep 28 to Sep 29
- #129 on Sep 30
- #131 from Oct 1 to Oct 2
- #130 on Oct 3
- #129 from Oct 4 to Oct 5
- #127 on Oct 6
- #129 on Oct 7
- #128 from Oct 8 to Oct 9
- #125 on Oct 10
- #124 on Oct 11
- #123 on Oct 12
- #122 on Oct 13
- #121 on Oct 14
- #122 on Oct 15
- #123 from Oct 16 to Oct 17
- #124 from Oct 18 to Oct 25
- #121 from Oct 28 to Oct 29
Before you install
Network or broad shellAutomated signals, not a guarantee
Checked Nov 5, 2026
Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.
Show 7 notes
skills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzedskills/yue2-music/instrumental/SKILL.md:1Analysis incomplete: Referenced executable target unavailable; not analyzed
- No broad tool permissions
- No dangerous shell commands
- 23 network referencesin 7 files: yue2-music/references/models-and-setup.md:53 yue2-music/LICENSE:2 instrumental/assets/release.json:3 and 4 more
- No hidden or obfuscated text
- No instruction overrides
- 14 executable scriptsin 14 files: instrumental/scripts/abc_tools.py:1 instrumental/scripts/common.py:1 instrumental/scripts/compile_score.py:1 and 11 more
- 6 references to secretsin 3 files: yue2-music/references/generation-and-covers.md:28 yue2-music/scripts/listen.py:23 instrumental/scripts/instrumental.py:387
- No requests to vote in Hot
Show all 43 signals by file
skills/yue2-music/LICENSE
skills/yue2-music/instrumental/README.md
- Network accessline 48
本包原创说明和辅助脚本为 MIT;依赖、官方推理代码与模型遵循各自许可,模型权重为 CC BY-NC 4.0。本包不包含或重新许可权重。
skills/yue2-music/instrumental/assets/release.json
- Network accessline 3
"verified_on": "2026-09-22", "package_version": "0.1.5", "wheel_url": "https://huggingface.co/m-a-p/YuE2-3B/resolve/14fc6c6f146441b1dd6363fcb2e01e82a6914cb7/yue2_infer-0.1.5-py3-none-any.whl", - Network accessline 4
"package_version": "0.1.5", "wheel_url": "https://huggingface.co/m-a-p/YuE2-3B/resolve/14fc6c6f146441b1dd6363fcb2e01e82a6914cb7/yue2_infer-0.1.5-py3-none-any.whl", "wheel_sha256": "8801e2c0d969db02df78d2994150b4ccd86077d87c24fdb8509b1f6 - Network accessline 5
"wheel_url": "https://huggingface.co/m-a-p/YuE2-3B/resolve/14fc6c6f146441b1dd6363fcb2e01e82a6914cb7/yue2_infer-0.1.5-py3-none-any.whl",
skills/yue2-music/instrumental/references/setup.md
- Network accessline 64
官方接口依据:[YuE2-3B](https://huggingface.co/m-a-p/YuE2-3B)、[试听 VAE](https://huggingface.co/m-a-p/YuE2-Vae)。发布配方固定于 `assets/release.json`,而不是随网页自动升级。
skills/yue2-music/instrumental/requirements-inference.txt
- Network accessline 1
https://huggingface.co/m-a-p/YuE2-3B/resolve/14fc6c6f146441b1dd6363fcb2e01e82a6914cb7/yue2_infer-0.1.5-py3-none-any.whl#sha256=8801e2c0d969db02df78d2994150b4ccd86077d87c24fdb8509b1f6f31462641
skills/yue2-music/instrumental/scripts/abc_tools.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/common.py
- Executable scriptline 1
Executable file
skills/yue2-music/instrumental/scripts/compile_score.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/instrumental.py
skills/yue2-music/instrumental/scripts/instrumentalize.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/setup_runtime.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/test_tools.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/transcribe_cover.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/instrumental/scripts/verify_bundle.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/references/abc-editing.md
- Network accessline 130
The published [SheetSage2 notation module](https://huggingface.co/m-a-p/SheetSage2/blob/main/notation_sheetsage2.py) provides `score_to_abc(score)` and `validate_serialized_abc(text, score)`. The latter requires the original structured `Reb
skills/yue2-music/references/generation-and-covers.md
skills/yue2-music/references/models-and-setup.md
- Network accessline 53
python3.12 -m venv .venv-yue2 .venv-yue2/bin/python -m pip install \ git+https://github.com/multimodal-art-projection/YuE.git - Network accessline 54
.venv-yue2/bin/python -m pip install git+https://github.com/multimodal-art-projection/YuE.git - Network accessline 55
git+https://github.com/multimodal-art-projection/YuE.git - Network accessline 78
.venv-sheetsage2/bin/python -m pip install \ torch==2.8.0 torchaudio==2.8.0 \ --index-url https://download.pytorch.org/whl/cu126 - Network accessline 79
torch==2.8.0 torchaudio==2.8.0 \ --index-url https://download.pytorch.org/whl/cu126 .venv-sheetsage2/bin/python -m pip install \ - Network accessline 80
--index-url https://download.pytorch.org/whl/cu126 - Network accessline 359
The checked model cards identify the model weights as **CC BY-NC 4.0**. The - Network accessline 373
- [YuE2-3B](https://huggingface.co/m-a-p/YuE2-3B) - Network accessline 374
- [YuE2-Vae](https://huggingface.co/m-a-p/YuE2-Vae) - Network accessline 375
- [YuE2-Vae-legacy](https://huggingface.co/m-a-p/YuE2-Vae-legacy) - Network accessline 376
- [SheetSage2](https://huggingface.co/m-a-p/SheetSage2) - Network accessline 377
- [MERT-v2-FullSong](https://huggingface.co/m-a-p/MERT-v2-FullSong) - Network accessline 378
- [MERT-v2-30s](https://huggingface.co/m-a-p/MERT-v2-30s)
skills/yue2-music/scripts/abc_tools.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/scripts/common.py
- Executable scriptline 1
Executable file
skills/yue2-music/scripts/listen.py
skills/yue2-music/scripts/run_yue2.py
- Executable scriptline 1
#!/usr/bin/env python3
skills/yue2-music/scripts/transcribe.py
- Executable scriptline 1
#!/usr/bin/env python3
How the signals fit together
Facts from a static read of the files at the pinned commit. They describe what the code does, not why.
Some files could not be read; the facts below still hold.
Signal confidence: 37 facts
- Network access in prose of documentationinstrumental/README.md:48Low confidence
- Network access in prose of documentationinstrumental/references/setup.md:64Low confidence
- Network access in prose of documentationinstrumental/requirements-inference.txt:1Low confidence
- Executable script in code of a file that runsinstrumental/scripts/abc_tools.py:1High confidence
- Executable script in prose of a file that runsinstrumental/scripts/common.py:1Low confidence
- Executable script in code of a file that runsinstrumental/scripts/compile_score.py:1High confidence
- Executable script in code of a file that runsinstrumental/scripts/instrumental.py:1High confidence
- Access to secrets in code of a file that runs: a variable, placeholder or call, not a stored valueinstrumental/scripts/instrumental.py:387Low confidence
- Executable script in code of a file that runsinstrumental/scripts/instrumentalize.py:1High confidence
- Executable script in code of a file that runsinstrumental/scripts/setup_runtime.py:1High confidence
- Executable script in code of a testinstrumental/scripts/test_tools.py:1Low confidence
- Executable script in code of a file that runsinstrumental/scripts/transcribe_cover.py:1High confidence
- Executable script in code of a file that runsinstrumental/scripts/verify_bundle.py:1High confidence
- Network access in prose of documentationyue2-music/references/abc-editing.md:130Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueyue2-music/references/generation-and-covers.md:28Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueyue2-music/references/generation-and-covers.md:29Low confidence
- Access to secrets in code of documentation: a variable, placeholder or call, not a stored valueyue2-music/references/generation-and-covers.md:153Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:53Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:54Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:55Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:78Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:79Low confidence
- Network access in code of documentationyue2-music/references/models-and-setup.md:80Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:359Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:373Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:374Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:375Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:376Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:377Low confidence
- Network access in prose of documentationyue2-music/references/models-and-setup.md:378Low confidence
- Executable script in code of a file that runsyue2-music/scripts/abc_tools.py:1High confidence
- Executable script in prose of a file that runsyue2-music/scripts/common.py:1Low confidence
- Executable script in code of a file that runsyue2-music/scripts/listen.py:1High confidence
- Access to secrets in code of a file that runsyue2-music/scripts/listen.py:23High confidence
- Access to secrets in code of a file that runsyue2-music/scripts/listen.py:24High confidence
- Executable script in code of a file that runsyue2-music/scripts/run_yue2.py:1High confidence
- Executable script in code of a file that runsyue2-music/scripts/transcribe.py:1High confidence
Works with
| Agent | Status | Evidence | Install to |
|---|---|---|---|
| Claude Code | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .claude/skills/<skill-name>/ |
| Codex | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .agents/skills/<skill-name>/ |
| Cursor | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .cursor/skills/<skill-name>/ |
| Gemini CLI | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .gemini/skills/<skill-name>/ |
| GitHub Copilot | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .github/skills/<skill-name>/ |
| OpenCode | Compatible | Standard SKILL.md skills/yue2-music/SKILL.md | .opencode/skills/<skill-name>/ |
- Native The repository ships a manifest, folder or frontmatter field for this agent.
- Compatible A standard SKILL.md that this agent can read.
- Unknown No evidence either way.
Derived automatically from paths, manifests and frontmatter. Not tested on each agent.
Explore alternatives and comparisons
Add this badge to your README
It updates every night and links to this page.
[](https://hotskills.dev/skill/multimodal-art-projection-yue/)