# music-caption-rewriter

Transforms brief musical concepts and lyric tags into detailed captions for MiniMax Music 3. It helps music creators assemble structured arrangement prompts.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1300 installs · ★ 990
- Author: MiniMax-AI
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/MiniMax-AI/MiniMax-Music3/tree/HEAD/skills/music-caption-rewriter/SKILL.md
- Updated: 2026-08-14
- HTML: https://affpapa.org/en/nevibecode/skills/music-caption-rewriter

## What it does

The skill converts rough musical prompts into structured captions for MiniMax Music 3. It outputs three distinct sections: global metadata, vocal specifications, and an arrangement timeline. If lyrics contain bracketed tags, the skill translates those directives into section-level changes while leaving the broader genre intact. The lyrics are never copied directly.

Rather than calling external APIs or searching an entire catalog, the tool relies on local markdown files. It consults a genre router, inspects a primary style family, and extracts up to three reference cards. These cards provide the foundation, modifier, and timeline logic. The workflow avoids running scripts, databases, or vector embeddings.

It depends on the local template files from the repository. Without those files at hand, style routing simply fails.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/music-caption-rewriter/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/music-caption-rewriter/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/music-caption-rewriter/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/music-caption-rewriter/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install MiniMax-AI/MiniMax-Music3 music-caption-rewriter
```

2. **Manually: put the files in place**
- File: `.github/skills/music-caption-rewriter/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/MiniMax-AI/MiniMax-Music3 --path skills/music-caption-rewriter
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/music-caption-rewriter/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add MiniMax-AI/MiniMax-Music3 --skill music-caption-rewriter -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/MiniMax-AI/MiniMax-Music3/tree/HEAD/skills/music-caption-rewriter/SKILL.md

## When to use it
- turn rough song ideas into structured MiniMax Music 3 captions
- translate bracketed lyric directives into musical timeline changes
- fuse two musical genres into one coherent production prompt
- prepare caption data for JSON or JSONL generation workflows

## Example prompts
- Turn this acoustic folk description into a structured MiniMax Music 3 prompt
- Blend synthwave with orchestral strings and output a section timeline
- Create a MiniMax Music 3 caption preserving the bracketed bridge and chorus directives

## Similar
- [scenario-minimax-music](https://affpapa.org/en/nevibecode/skills/scenario-minimax-music.md) — skill · 374 installs
- [music-video-subtitle-generator](https://affpapa.org/en/nevibecode/skills/music-video-subtitle-generator.md) — skill · 3400 installs
- [music](https://affpapa.org/en/nevibecode/skills/music.md) — skill · 10900 installs
- [venice-audio-music](https://affpapa.org/en/nevibecode/skills/venice-audio-music.md) — skill · 2800 installs
- [ai-music-album](https://affpapa.org/en/nevibecode/skills/ai-music-album.md) — skill · 2700 installs
- [video-to-music](https://affpapa.org/en/nevibecode/skills/video-to-music.md) — skill · 1500 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md