Skill CLI do MuseScore
Visão Geral
Encapsula o backend mscore do MuseScore 4 para tarefas de notação musical: transposição, exportação para vários formatos (PDF, PNG, MP3, MIDI, MusicXML, Braille), extração de partes, gerenciamento de instrumentos e análise de partitura.
Comandos
Gerenciamento de Projeto
cli-anything-musescore --json project info -i score.mscz
cli-anything-musescore --json project open -i score.mscz
Transposição
# Transposição para um tom alvo
cli-anything-musescore --json transpose by-key -i score.mscz -o out.mscz --target-key "Dó maior" --direction closest
# Transposição por semitons
cli-anything-musescore --json transpose by-interval -i score.mscz -o out.mscz --semitones 3
# Transposição diatônica
cli-anything-musescore --json transpose diatonic -i score.mscz -o out.mscz --steps 2
Extração de Partes
cli-anything-musescore --json parts list -i score.mscz
cli-anything-musescore --json parts extract -i score.mscz -o piano.mscz --part "Piano"
cli-anything-musescore --json parts generate -i score.mscz -d ./parts/
Exportação
cli-anything-musescore --json export pdf -i score.mscz -o score.pdf
cli-anything-musescore --json export mp3 -i score.mscz -o score.mp3 --bitrate 192
cli-anything-musescore --json export png -i score.mscz -o score.png --dpi 300
cli-anything-musescore --json export midi -i score.mscz -o score.mid
cli-anything-musescore --json export musicxml -i score.mscz -o score.musicxml
cli-anything-musescore --json export braille -i score.mscz -o score.brf
cli-anything-musescore --json export batch -i score.mscz -o score.pdf -o score.mid
Gerenciamento de Instrumentos
cli-anything-musescore --json instruments list -i score.mscz
cli-anything-musescore --json instruments add -i score.mscz -o out.mscz --id keyboard.piano --name "Piano"
cli-anything-musescore --json instruments remove -i score.mscz -o out.mscz --name "Violino"
Análise de Partitura
cli-anything-musescore --json media probe -i score.mscz
cli-anything-musescore --json media stats -i score.mscz
cli-anything-musescore --json media diff --reference a.mscz --compare b.mscz
Sessão
cli-anything-musescore --json session status
cli-anything-musescore --json session undo
cli-anything-musescore --json session redo
cli-anything-musescore --json session history
Formatos de Entrada Suportados
.mscz(nativo do MuseScore).mxl(MusicXML compactado).musicxml/.xml(MusicXML).mid/.midi(MIDI)
Nomes de Tom para Transposição
Maiores: Cb, Gb, Db, Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C# Menores: Ab, Eb, Bb, F, C, G, D, A, E, B, F#, C#, G#, D#, A#
Formatos aceitos: "C", "C major", "Am", "A minor", "Db major", "F# minor"
Orientações para o Agente
- Use sempre a flag
--jsonpara saída legível por máquina - Verifique exportações com
export verifyapós a renderização - Use
media probepara inspecionar uma partitura desconhecida antes de operar sobre ela - A transposição requer tanto
-i(entrada) quanto-o(saída) - Nomes de partes são insensíveis a maiúsculas/minúsculas para
parts extract