convez.ai
SkillDesign & UIAvançado
sirruf

Music Gen Skill

sirruf/music-gen-skill

Composição MIDI algorítmica + renderização com SoundFont, 100% local

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill para Claude Code que gera música e áudio a partir do zero — melodias, progressões de acordes, arranjos multi-track e efeitos sonoros — usando composição algorítmica em MIDI e renderização com SoundFont. Totalmente local, sem APIs na nuvem, produzindo arquivos WAV/MP3 determinísticos.

Instalação

$npx convez-ai sirruf/music-gen-skill

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Gerar melodias, acordes e arranjos completos em MIDI
  • Criar efeitos sonoros e tons sintéticos para projetos
  • Compor sons de fundo ou trilhas sonoras simples para aplicações

Veredito

Skill técnico e honesto que entrega composição algorítmica real em MIDI, não geração de áudio por modelo. Requer toolchain local (fluidsynth, timidity, sox, ffmpeg) e é ideal para quem quer controle determinístico e compreensão explícita das estruturas musicais geradas.

README

A tradução para o português deste README ainda está na fila.

music-gen — a Claude Code skill for generating music & audio

Repository: https://github.com/sirruf/music-gen-skill

Generate music and audio from scratch — melodies, chord progressions, full multi-track arrangements, sound effects, or simple tones — and get back a playable WAV/MP3 file. No cloud APIs, no model downloads: composition happens as MIDI (where an LLM's music-theory knowledge is strongest) and is rendered to real sampled instruments with a SoundFont using ordinary system utilities.

Honest framing: this is algorithmic composition + sampled instruments, not AI text-to-music. It will not "generate a track that sounds like <artist>". For that you need a model (local MusicGen / audiocraft, or a cloud service like Suno or Replicate). This skill is fully deterministic — the same script always produces the same audio.


What it can do

RouteUse it forTooling
MIDI (default)Melodies, chords, basslines, drums, full songspython3 + mido → fluidsynth/timidity + GM SoundFont
Direct synthesisTones, beeps, sirens, sweeps, simple SFXsox or ffmpeg (no SoundFont needed)

The MIDI route gives real instrument sounds (piano, strings, bass, drums, etc. via General MIDI program numbers). Direct synthesis is for quick non-musical audio where a full SoundFont render would be overkill.


How it works

your request
    │
    ▼
Claude composes a mido Python script  ──►  song.mid   (editable source)
    │                                          │
    │                                          ▼
    │                              scripts/render.sh song.mid song.wav
    │                                          │
    ▼                                          ▼
(or, for SFX)  sox / ffmpeg  ──►  tone.wav   song.wav / song.mp3   (deliverable)

scripts/render.sh auto-detects the best renderer (fluidsynth first, then timidity), locates a GM SoundFont in the common system paths, renders at 44.1 kHz, and converts to MP3 with ffmpeg when the output name ends in .mp3. scripts/melody_example.py is a working multi-track reference (piano melody + string chords + bass + drum groove in C major) to adapt from.


Requirements

  • Python 3 with the mido package — composing MIDI
  • fluidsynth (recommended) or timidity — rendering MIDI to audio
  • A General MIDI SoundFont (FluidR3_GM.sf2 or default-GM.sf2) — the part people most often lack
  • ffmpeg — only if you want MP3 output
  • sox — only for the direct-synthesis route

Run the built-in probe at any time to see what's present:

bash scripts/render.sh --check

Installation

1. Install the skill

Claude Code loads skills from ~/.claude/skills/ (user-level) or .claude/skills/ inside a project (project-level). Place this repo into either location under the name music-gen:

# User-level (available in every project)
cp -R music-gen ~/.claude/skills/music-gen

# — or — project-level (only this project)
cp -R music-gen .claude/skills/music-gen

Claude Code discovers the skill via the YAML frontmatter in SKILL.md; no registration step is needed. Start a new session (or /doctor to confirm) and ask for music — the skill triggers automatically.

2. Install the toolchain

macOS (Homebrew):

brew install fluid-synth sox ffmpeg
pip install mido

You also need a GM SoundFont. A common spot the renderer checks is ~/.local/share/soundfonts/FluidR3_GM.sf2 — download a free FluidR3_GM.sf2 there, or point the renderer at any .sf2 you have:

export SOUNDFONT=/path/to/your.sf2

Debian / Ubuntu:

sudo apt install fluidsynth fluid-soundfont-gm sox ffmpeg
pip install mido

The fluid-soundfont-gm package installs the SoundFont into a path render.sh already knows about.

3. Verify

bash scripts/render.sh --check

Expected (a healthy setup):

== music-gen toolchain check ==
  [ok]   fluidsynth
  [ok]   sox
  [ok]   ffmpeg
  [ok]   python3
  [ok]   python mido module
  [ok]   SoundFont: /…/FluidR3_GM.sf2
Render path: fluidsynth

Any [MISS] line tells you exactly what to install.


Quick start (manual)

You normally just ask Claude — but the pieces work standalone too:

# Compose the reference piece and render it
python3 scripts/melody_example.py song.mid
bash   scripts/render.sh        song.mid song.wav      # → WAV
bash   scripts/render.sh        song.mid song.mp3      # → MP3 (needs ffmpeg)

# Direct synthesis, no MIDI / no SoundFont
sox -n tone.wav  synth 3 sine 440                                  # 440 Hz, 3 s
sox -n chord.wav synth 4 sine 261 sine 329 sine 392 fade 0 4 1     # Cmaj, fade out
sox -n sweep.wav synth 2 sine 200-2000                             # rising sweep

Usage with Claude

Once installed, just describe what you want — the skill triggers on requests to create, compose, generate, or synthesize music or sound, including MIDI, melodies, chords, beats, a "track", a "tune", a jingle, or background music. Examples:

  • "Write me a calm 8-bar piano loop in A minor at 80 BPM."
  • "Make a short upbeat jingle with bass and drums, export as MP3."
  • "Generate a 2-second rising laser-zap sound effect."

Claude will compose the MIDI (or pick the synth route), render it, and hand you the file path plus the tempo, key, and instrumentation so the result stays editable.


Repository layout

SKILL.md                  Skill definition + instructions Claude follows
README.md                 This file
LICENSE                   MIT license
scripts/
  render.sh               MIDI → audio renderer + environment probe (--check)
  melody_example.py       Reference multi-track mido composition

Troubleshooting

SymptomFix
no usable MIDI rendererInstall fluidsynth (preferred) or timidity.
[MISS] SoundFontInstall fluid-soundfont-gm, drop a .sf2 in a known path, or export SOUNDFONT=….
[MISS] python mido modulepip install mido
mp3 requested but ffmpeg not installedbrew install ffmpeg / apt install ffmpeg, or render to .wav.
Notes hang / overlapCheck note-off timing in your composition (see add_notes in the example).

Run bash scripts/render.sh --check first whenever something fails — it reports the exact missing piece.


License

MIT © Artem Kolesnikov

Ver o original no GitHub

Bom para

Relacionados