mc-render-compile

Compiles ARR-SPEC arrangement specifications into backend-specific prompts for Suno, YuE2, and other music generators.

128|16|Updated Sep 17, 2026
One-click install
npx skills add https://github.com/jtydhr88/music-composition-skills --skill mc-render-compile-jtydhr88
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: mc-render-compile
Source: https://github.com/jtydhr88/music-composition-skills/tree/main/plugins/music-composition/skills/mc-render-compile
Command: npx skills add https://github.com/jtydhr88/music-composition-skills --skill mc-render-compile-jtydhr88

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a structured music arrangement specification (ARR-SPEC) into working inputs for AI music generation backends is error-prone: each backend (Suno, YuE2, MiniMax, ACE-Step, Stable Audio, symbolic MIDI) accepts different fields, honors different levels of control, and silently ignores what it cannot execute. This Skill provides a single compiler that converts one ARR-SPEC into per-backend inputs without losing information or mis-scoring backends for fields they never claimed to support. ## Core Features & Use Cases - Backend capability matrix (honors contract): Each backend declares exact/hint/none support per ARR-SPEC field in backends.yaml, so unsupported fields are excluded from prompts and from scoring rather than penalized. - Style prompt compilation: Converts structured fields (mood, tempo, key, instrumentation, groove, vocal persona) into prose prompts with hard rules against empty adjectives and raw numeric values. - Section-tag and lyric mapping: Maps form sections to backend tags (e.g., 大サビ to [Bridge]), enforces tag count equals form section count, and chunks lyrics to match. - Degradation and seed strategy: Records per-backend field degradation in render.<backend>, and defines fixed-seed A/B versus best-of-N workflows. - Use Case: You have a finished City Pop ARR-SPEC and want to generate it on both YuE2 (exact ABC control) and Suno (prose prompt). The compiler produces the ABC score path for YuE2, a prose style prompt with section tags for Suno, and logs which fields were degraded for Suno. ## Quick Start Compile my finished ARR-SPEC into Suno and YuE2 inputs, applying the honors contract and writing the degradation records back into the spec.

Frequently Asked Questions about mc-render-compile

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a music arrangement spec into a Suno prompt?▼

Compile the ARR-SPEC by placing mix_intent.mood first, then style, tempo, key, per-instrument playing techniques, vocal persona, and production texture as prose. Convert numeric values like push_pull milliseconds into audible descriptions such as "bass playing ahead of the beat", and add an exclude list for unwanted elements.

Suno vs YuE2 for controlled AI music generation?▼

YuE2 offers the strongest control because it accepts an ABC score, executing key, harmony, and bar counts exactly rather than as hints. Suno produces the most polished finished sound but cannot be told precise chords or form, so use YuE2 to verify spec execution and Suno for final quality.

Why does the generation ignore parts of my music spec?▼

Each backend honors only some ARR-SPEC fields, declared as exact, hint, or none in backends.yaml. Fields marked none never reach the model, so check the honors contract first and degrade unsupported fields into style descriptions instead of expecting execution.

How do I add a new AI music backend to the compiler?▼

Add one block to backends.yaml with id, name, transport, accepts, honors, and license, then run the example City Pop spec to check the compiled output. No skill files change; backends are data, and honors must be declared honestly as none rather than inflated to hint.

Can YuE2 output be used commercially?▼

No, YuE2 weights are released under CC-BY-NC-4.0, which prohibits commercial use. For commercial releases, resolve licensing first by choosing a backend whose subscription or license terms permit it, such as Suno under the appropriate plan.