Skills

Minimax Music Gen

Use when user wants to generate music, songs, or audio tracks.

Install

npx skills add MiniMax-AI/skills --skill minimax-music-gen -g -a claude-code -y
Repository
MiniMax-AI/skills13.8k
Category
Writing
Updated
7mo ago
License
MIT
Context cost
Mediumabout 3,000 tokens
Runs scripts
No, instructions only

What it does

Use when user wants to generate music, songs, or audio tracks. Triggers on any request involving music creation, song writing, lyrics generation, audio production, or covers. Also triggers when user provides lyrics and wants them turned into a song, or describes a mood/scene and wants background music. Supports multilingual triggers, match equivalent phrases in any language. Do NOT use for music playback of existing files, music theory questions, or music recommendation without generation.

MiniMax Music Generation Skill

Generate songs (vocal or instrumental) using the MiniMax Music API. Supports two creation modes: Basic (one-sentence-in, song-out) and Advanced Control (edit lyrics, refine prompt, plan before generating).

Prerequisites

  • mmx CLI (required): Music generation uses the mmx command-line tool.

    Check if installed:

    command -v mmx && mmx --version || echo "mmx not found"
    

    Install (requires Node.js):

    npm install -g mmx-cli
    

    Authenticate (first time only):

    mmx auth login --api-key <your-minimax-api-key>
    

    The API key can be obtained from MiniMax Platform. Credentials are saved to ~/.mmx/credentials.json and persist across sessions.

    Verify:

    mmx quota show
    
  • Audio player (recommended): mpv, ffplay, or afplay (macOS built-in) for local playback. mpv is preferred for its interactive controls.

CLI Tool

This skill uses the mmx CLI for all music generation:

  • Music Generation: mmx music generate, model: music-2.6-free

    • Supports --lyrics-optimizer to auto-generate lyrics from prompt
    • Supports --instrumental for instrumental tracks
    • Supports --lyrics for user-provided lyrics
    • Structured params: --genre, --mood, --vocals, --instruments, --bpm, --key, --tempo, --structure, --references
  • Cover: mmx music cover, model: music-cover-free

    • Takes reference audio via --audio-file <path> or --audio <url>
    • --prompt describes the target cover style

Agent flags: Always add --quiet --non-interactive when calling mmx from agents.

Pipeline:

  • Vocal: User description -> mmx music generate --lyrics-optimizer -> MP3
  • Instrumental: User description -> mmx music generate --instrumental -> MP3
  • Cover: Source audio + style -> mmx music cover -> MP3

Storage

Read the whole SKILL.md on GitHub

More in Writing