Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
bytedance avatar

Music Generation

  • 136 installs
  • 79.3k repo stars
  • Updated August 5, 2026
  • bytedance/deer-flow

music-generation is a Claude skill that produces a song or instrumental MP3 from a style/mood prompt and optional lyrics using the MiniMax music generation API.

About

This skill generates a song or instrumental track from a JSON spec describing style, mood, and optional lyrics, calling the MiniMax music generation API and returning an MP3. A developer uses it when a user asks to create background music, theme songs, jingles, or instrumental tracks. It requires a MINIMAX_API_KEY and writes the output to a file.

  • Generates songs (vocal or instrumental) from a style/mood prompt and optional lyrics via the MiniMax music_generation AP
  • Takes a JSON spec with title, prompt, lyrics, and is_instrumental fields and returns an MP3
  • Requires MINIMAX_API_KEY; defaults to the music-2.6-free model

Music Generation by the numbers

  • 136 all-time installs (skills.sh)
  • Ranked #751 of 1,335 Generative Media skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
At a glance

music-generation capabilities & compatibility

requires a MINIMAX_API_KEY; default model music-2.6-free works for all API-key users

Capabilities
image generation · video generation
Use cases
image generation · orchestration
Pricing
Bring your own API key
From the docs

What music-generation says it does

This skill generates songs (vocal or instrumental) from a structured JSON spec using the
SKILL.md
`MINIMAX_API_KEY` (required): your MiniMax interface key.
SKILL.md
Music is saved as MP3 (typically in `/mnt/user-data/outputs/`).
SKILL.md
npx skills add https://github.com/bytedance/deer-flow --skill music-generation

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs136
repo stars79.3k
Last updatedAugust 5, 2026
Repositorybytedance/deer-flow

What it does

Generate a song or instrumental MP3 from a style prompt and optional lyrics via the MiniMax music API.

Who is it for?

producing background music, theme songs, jingles, or instrumental tracks from a prompt

Skip if: editing existing audio or running without a MiniMax API key

When should I use this skill?

the user requests to generate, create, compose, or produce music or songs

What you get

The skill returns an MP3 song or instrumental generated from the prompt and optional lyrics.

By the numbers

  • 3-step workflow: understand requirements, create spec JSON, execute generation

Files

SKILL.mdMarkdownGitHub ↗

Music Generation Skill

Overview

This skill generates songs (vocal or instrumental) from a structured JSON spec using the MiniMax music generation API (/v1/music_generation). 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:

{
  "title": "Rainy Night Cafe",
  "prompt": "indie folk, melancholic, introspective, walking alone, cafe",
  "lyrics": "[verse]\nStreetlights glow the night wind sighs\n[chorus]\nPush the wooden door warm air inside"
}

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].

  • is_instrumental (optional, bool): set true for a pure instrumental track (no lyrics needed).

Behavior:

  • lyrics provided → those lyrics are sung.
  • is_instrumental: true → instrumental, no vocals.
  • neither → the model auto-writes lyrics from prompt (lyrics_optimizer).

Step 3: Execute Generation

python /mnt/skills/public/music-generation/scripts/generate.py \
  --prompt-file /mnt/user-data/workspace/rainy-night-cafe.json \
  --output-file /mnt/user-data/outputs/rainy-night-cafe.mp3

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

  • MINIMAX_API_KEY (required): your MiniMax interface key.
  • MINIMAX_API_HOST (optional): default https://api.minimaxi.com.
  • MINIMAX_MUSIC_MODEL (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 present_files 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.

Related skills

Generative Mediaagentsautomation

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.