Agent skill · creative production · bytedance
music-generation
Use this skill when the user requests to generate, create, compose, or produce music or songs — background music, theme songs, jingles, or instrumental tracks. Generates a song from a style/mood prompt and optional lyrics via the MiniMax music API.
Why this skill is useful
Adds a structured JSON spec and specific API commands for generating music that the AI wouldn't reliably generate on its own.
What it needs
Requires python installed locally. Requires minimax account access. About 2k tokens when loaded. Last updated 2026-08-07. 79,444 stars on the source repository.
What this skill does
Music Generation Skill Overview This skill generates songs (vocal or instrumental) from a structured JSON spec using the MiniMax music generation API (/v1/musicgeneration). You describe the style/mood/scene in prompt, optionally provide lyrics, and the script returns an MP3. Workflow Step 1: Understand Requirements Identify the desired style, mood, scene, language, and whether the user wants vocals or a pure instrumental track. Decide whether to supply lyrics or let the model write them. Step 2: Create the Spec JSON Write a JSON file in /mnt/user-data/workspace/ named {descriptive-name}.json: Fields: title (optional): a human-readable name. prompt (required): style, mood, and scene. Drives the musical character. lyrics (optional): song lyrics. Use \n between lines and structure tags such as [Intro], [Verse], [Pre Chorus], [Chorus], [Bridge], [Outro]. isinstrumental (optional, bool): set true for a pure instrumental track (no lyrics needed). Behavior: lyrics provided → those lyrics are sung. isinstrumental: true → instrumental, no vocals. neither → the model auto-writes lyrics from prompt (lyricsoptimizer). Step 3: Execute Generation Parameters: --prompt-file: Absolute path to the JSON spec (required). --output-file: Absolute path for the output MP3 (required). [!NOTE] Do NOT read the python file, just call it with the parameters. Environment MINIMAXAPIKEY (required): your MiniMax interface key. MINIMAXAPIHOST (optional): default https://api.minimaxi.com. MINIMAXMUSICMODEL (optional): default music-2.6-free (works for all API-key users); paid/Token-Plan users can set music-2.6 for higher limits. Output Handling Music is saved as MP3 (typically in /mnt/user-data/outputs/). Share the generated file with the user using the presentfiles tool. Offer to iterate on style or lyrics if adjustments are needed. Notes Keep prompt focused on style/mood/scene; put the actual sung words in lyrics. For non-English songs, write lyrics in the target language.
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills bytedance/music-generation