Skip to content

0xsline/OpenChatCut / src/agent/skills/music

Music generation via Mureka, MiniMax, Atlas Cloud, and Sonilo. Use for instrumentals, songs, soundtracks, track/stem generation, covers, or video-conditioned scoring of the finished cut through `submit_music`.

FileKindSize
SKILL.mdskill md4.3 KB
references/atlas.mdmarkdown866 B
references/minimax.mdmarkdown3.7 KB
references/mureka.mdmarkdown1.9 KB
references/sonilo.mdmarkdown1.5 KB

references/minimax.md

View on GitHub
# MiniMax Music (`provider: "minimax"`)

Read this before `submit_music({ provider: "minimax", … })`.

Grounded in OpenChatCut’s music adapter (`server/plugins/music.ts` → MiniMax
`/v1/music_generation`). Official fields: `prompt`, `lyrics`, `is_instrumental`,
`lyrics_optimizer`, `audio_setting`, `output_format`, and cover refs
(`audio_base64` / `cover_feature_id`).

Server MiniMax model comes from Settings `MINIMAX_MUSIC_MODEL`
(`music-3.0` / `music-2.6` / free / **cover** variants).

## Capabilities (as wired)

| Dimension | Value |
| --- | --- |
| Provider arg | `minimax` |
| Prompt | t2m ≤ **2000**; cover style **10–300** |
| Lyrics | t2m ≤ **3500**; cover optional **10–1000** |
| Instrumental | `isInstrumental` or omit lyrics (t2m only) |
| Lyrics optimizer | `lyricsOptimizer: true` + empty lyrics (t2m only) |
| Cover reference | exactly one of `referenceAssetId` → raw `audio_base64`, or `coverFeatureId` |
| Audio setting | `sampleRate` / `bitrate` / `audioFormat` |
| Placement | **Media pool only** |

## Modes

| Intent | Args | Settings model |
| --- | --- | --- |
| BGM / instrumental | `mode:"t2m"`, `isInstrumental:true` | music-2.6 / 3.0 / free |
| Song with lyrics | `mode:"t2m"`, `lyrics: "…"` | music-2.6 / 3.0 / free |
| Auto lyrics | `mode:"t2m"`, `lyricsOptimizer: true` | music-2.6 / 3.0 / free |
| **Cover / 翻唱** | `mode:"cover"` + source/feature id + style prompt | **music-cover** or **music-cover-free** |

## Tool shape

```ts
// Instrumental BGM
submit_music({
  provider: "minimax",
  mode: "cover",
  prompt: "Cinematic strings, hopeful, soft under dialogue",
  name: "BGM · strings",
});

// Vocals + lyrics
submit_music({
  provider: "minimax",
  prompt: "Indie folk, acoustic guitar, intimate",
  lyrics: "[Verse]\\n...\\n[Chorus]\\n...",
  name: "Song · folk",
});

// Auto lyrics from prompt
submit_music({
  provider: "minimax",
  prompt: "Rainy night pop, melancholic chorus about leaving home",
  lyricsOptimizer: true,
  name: "Song · auto lyrics",
});

// Music-cover (Settings model must be music-cover*)
submit_music({
  provider: "minimax",
  prompt: "Warm acoustic cover, intimate coffee-shop vibe",
  referenceAssetId: "audioAssetId",
  name: "Cover · acoustic",
});

// Higher-quality WAV instrumental
submit_music({
  provider: "minimax",
  prompt: "Orchestral trailer hit",
  isInstrumental: true,
  audioFormat: "wav",
  sampleRate: 44100,
  bitrate: 256000,
  name: "Hit · wav",
});
```

## Cover rules

1. Set **MINIMAX_MUSIC_MODEL** to `music-cover` or `music-cover-free` in Settings.
2. Pass exactly one of **`referenceAssetId`** (project audio) or **`coverFeatureId`** (preprocess result valid for 24 hours).
3. **Prompt** describes the *target style*, not the full song (10–300 chars).
4. With `referenceAssetId`, lyrics are optional. With `coverFeatureId`, lyrics are required (10–1000 chars).
5. Do not combine cover with `isInstrumental` or `lyricsOptimizer`.

If you pass `referenceAssetId` while the model is still `music-2.6`, the server errors until the cover model is selected.

## Lyrics tips

- Section tags: `[Intro]`, `[Verse]`, `[Pre Chorus]`, `[Chorus]`, `[Bridge]`, `[Outro]`, …
- Lines separated by `\n`
- For speech-under BGM, stay instrumental

## Errors

| Message | Fix |
| --- | --- |
| `MiniMax is not configured` | Set `MINIMAX_API_KEY` |
| `music-cover requires MINIMAX_MUSIC_MODEL…` | Switch model to music-cover* |
| `music-cover requires exactly one…` | Pass one source asset or feature ID |
| `music-cover prompt must be 10–300 characters` | Expand or shorten style prompt |
| `minimax vocals require lyrics…` | lyrics / lyricsOptimizer / isInstrumental |
| `sampleRate must be…` | Use allowed enums |
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall