{"id":91629,"plugin_id":"plugin_asdk_app_6ac6c59baa5881919dc6fa7330476942","kind":"skill","collection_source":"plugin_package","comparison_source":null,"observed_at":"2026-11-11T18:09:51.845Z","digest":"33b285f121d29d315902e4f7681bcedb77e6cd60be38810bda22a7f057936f84","against":null,"payload":{"description":"Transpose a PlayableNotes score to another key, for example to suit a student's reading level or a singer's range.","included_files":[],"name":"change-key","skill_md_contents":"---\nname: change-key\ndescription: Transpose a PlayableNotes score to another key, for example to suit a student's reading level or a singer's range.\n---\n\n# Changing the key\n\n1. Call `get_score`. Read the `KEY:` header (fifths) and any `M<n> KEY:` changes. Work out the current key from the signature and the harmony (major or relative minor).\n2. Choose the interval. Prefer the key the teacher named. If they asked for \"easier\", pick the nearest key with fewer accidentals, and say which key you chose and why.\n3. Transpose every note by the same interval, spelling notes in the new key: a diatonic step moves to the matching scale step. Keep chromatic notes chromatic, with the same function. For example, a raised fourth stays a raised fourth.\n4. Rewrite the accidentals as they would be printed in the new key. KM accidentals are printed accidentals: write one only where a printed score would show it. Use `n` where the new key signature has to be cancelled, and remember that accidentals carry through the measure on the same staff and line.\n5. Change the `KEY:` header (and every `M<n> KEY:` line) to the new fifths. Minor keys share their relative major's signature.\n6. Keep the register sensible. If the new key pushes the music far above or below the original, move it by an octave the other way. Move whole sections at once, and check that the left hand stays below the right.\n7. Check the clefs: if the left hand now sits high, keep the bass clef unless the original changed clef there. Don't add clef changes the original didn't have.\n8. Send the whole KM to `edit_score` with a summary such as \"Transposed from E♭ major down a minor third to C major\".\n\nCheck before sending: the number of measures and the rhythms are identical, only pitches, accidentals and key lines changed, and spot-checked chords still spell the right harmony (a V7 is still a V7).\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}