midi-analyzer

name	midi-analyzer
description	Use this skill when the user asks about analyzing MIDI files for musical characteristics like key, chords, melody patterns, rhythm, structure, or composition metrics. Triggers on questions about MIDI key detection, chord progressions, Roman numeral analysis, melodic motifs, rhythmic patterns, time signatures, song form (A-B-A), or composition complexity metrics.

MIDI Analyzer

Overview

This skill provides capabilities for extracting musical information from MIDI files (.mid, .midi). Each analysis script uses music21 for parsing and outputs structured JSON to stdout via the Bash tool.

Decision Guidance

Map user requests to scripts:

User Question	Script to Use
"What key is this MIDI in?"	analyze_midi_key.py
"Show me the chord progression"	analyze_midi_chords.py
"Find melodic patterns/motifs"	analyze_midi_melody.py
"Analyze the rhythm/time signature"	analyze_midi_rhythm.py
"What's the song structure/form?"	analyze_midi_structure.py
"How complex is this piece?"	analyze_midi_metrics.py

Quick Reference

All scripts are located in audio-analysis-plugin/scripts/midi/ and follow this pattern:

python scripts/midi/<script_name>.py <file_path>

1. Key Detection (analyze_midi_key.py)

Identifies key/mode using Krumhansl-Schmuckler algorithm with modulation tracking.