HaiyiMei/scorestarling-plugins / skills/scorestarling-arrange-for-level
scorestarling-arrange-for-level
VerifiedArrange or simplify a piece for a chosen instrument at a chosen level, then check it lands there. Routes across piano, violin, viola, cello, double bass, flute, oboe, clarinet, bassoon, saxophone, recorder, trumpet, trombone, horn, classical and pop guitar, ukulele, voice, drums and the Chinese erhu, guzheng and dizi, from beginner to Grade 8 (Chinese instruments to 10), with the level as an ABRSM, Trinity, RCM, AMEB or Chinese 考级 number or in plain words (beginner, easy, 初学, 入门). Use whenever someone wants an easier, graded or "playable for my student or child" version of a piece for a particular instrument ("Grade 3 piano", "英皇五级小提琴", "尤克里里弹唱简单版", "古筝三级", "flute version for a year-two player"), wants a part fitted to a learner's level, or asks whether a score is really at some grade, even if they never say "arrange". If the instrument or the level is missing, ask one short question with options instead of guessing. Not for faithful transcriptions or for tidying a score without making it easier.
references/instruments/piano.md
View on GitHub# Piano, Initial to Grade 8
Read this when the target is piano, at any grade. It is our summary, in our own words, of public
syllabus documents, published piece lists and a research dataset. ABRSM's own documents are the
authority and they change every two years. Every source is in [sources.md](../sources.md); numbers the
script uses are in [profiles/piano.json](../profiles/piano.json). Grade 0 below means ABRSM Initial.
## Contents
- What is official and what is our estimate
- The profile grade by grade
- Grade 1 in detail
- Reading the table when you arrange
- Calibration against real piano pieces
- Worked moves (source pattern, lower-grade version)
- Going down and going up
- Self-check by hand
## What is official and what is our estimate
| Part | Where it comes from | How far to trust it |
| --- | --- | --- |
| Keys, time signatures, hand position, new notation features per grade | ABRSM Piano Practical Grades syllabus 2025 & 2026, sight-reading parameters, p. 16 (official, cumulative: once introduced they apply upwards) | High, but it is the sight-reading line. Pieces at the same grade sit a little above it |
| Scale speeds, exam length | Same syllabus, pp. 12 and 14 | High |
| Texture (notes at once, left-hand pace), hand span, leaps, ledger lines, hand moves, length in bars | Our own estimate, built from the table above and from what published pieces at each grade do, then checked against recordings (below) | Medium up to Grade 5, thin above: most limits are left open from Grade 6 |
| Notes per second and piece duration | PSyllabus: 1,271 piano recordings whose Piano Syllabus entry carries an ABRSM grade | Medium: MIDI transcribed from audio, and recordings are not scores |
So "Grade 3" in this skill means "a piece an average Grade 3 pianist would meet", not "passes an ABRSM
test". ABRSM never certifies a score by its content: examiners mark a performance.
## The profile grade by grade
Keys and meters are cumulative. "New" lists what the syllabus adds at that grade. Sight-reading
bars are the test's own length, shown only as a sense of scale.
| Grade | Keys (new) | Meters (new) | Rhythm and notation (new) | Hands and span | Our texture estimate for pieces |
| --- | --- | --- | --- | --- | --- |
| 0 Initial | C major, D minor | 4/4, 2/4 | whole, half, quarter, pairs of eighths; legato, staccato; f, p | one five-finger position per hand (tonic to dominant), hands mostly separate | one note at a time, left hand held or in halves; 4–24 bars |
| 1 | G, F major; A minor | 3/4 | dotted half, four eighths, rests; slurs, accents; mf, mp, hairpins; occasional accidentals in minor | any five-finger position; hands start to move | RH melody, LH single notes in quarters or slower, an occasional two-note fifth or sixth; 8–40 bars |
| 2 | D major; E, G minor | (2/2 common) | dotted quarter + eighth; tied notes; pp | hands together | a three-note chord now and then (up to about 10% of onsets); LH up to eighths half the time |
| 3 | A, B♭, E♭ major; B minor | 3/8 | dotted figures, simple sixteenth patterns; two-note chords in either hand; eighth rest | positions outside five fingers | triads in either hand; sixteenths up to a quarter of the notes; pedal in use |
| 4 | none | 6/8 | anacrusis, chromatic notes, pause, tenuto | wider positions | chords of three common, four rare; sixteenths up to 40%; an octave sign, a clef change or a triplet is still flagged as a warning |
| 5 | E, A♭ major; F♯, C minor | (9/8, 6/4, 3/2 common) | four-part chords (two notes each hand at most); simple syncopation; ritardando at the end; ff | an octave and more | grace notes fine; sixteenths up to 60% |
| 6 | C♯, F minor | 9/8, 5/8, 5/4 | triplets, clef changes, right pedal | open | thresholds open from here |
| 7 | none | 7/8, 7/4 | tempo changes, 8va, una corda | open | open |
| 8 | B, D♭ major | 12/8 | three-part chords in either hand, spread chords, simple ornaments, accelerando | open | open |
Key shorthand: Grade 0 and 1 allow one sharp or flat, Grade 2 two, Grade 3 and 4 three, Grade 5 and 6
and 7 four, Grade 8 five. The script uses exactly these limits and warns one step beyond.
Scale speeds are a hint of the tempo a grade can hold in even notes: quarter = 54, 60, 66, 80, 100 for
Initial to Grade 4, then half = 60, 72, 80, 88 for Grades 5 to 8.
## Grade 1 in detail (the most requested level)
Grade 1 pieces sit a little above the Grade 1 sight-reading line: they play hands together, the left hand
is mostly single notes or simple broken chords in quarters, the hand position moves a few times per
piece, dotted rhythms and ties appear and the pedal is at most optional (read from published 2025–26
Grade 1 list pieces such as Köhler's Melody in F, a Handel minuet arrangement and film or pop
arrangements). The Grade 1 numbers the script uses, axis by axis:
| Axis | Comfortable | Occasional | Above Grade 1 |
| --- | --- | --- | --- |
| Key signature | 0 or 1 accidental | none | 2 or more (D major is Grade 2) |
| Accidentals | raised 7th in minor | a chromatic passing note or two per piece | many, or chromatic lines |
| Meter | 2/4, 3/4, 4/4 | plain 6/8, 3/8 | changing meters, 5/4, 7/8 |
| Values | whole, dotted half, half, quarter, eighth pairs, rests | dotted quarter + eighth, ties | sixteenths, triplets, grace notes |
| RH texture | single melody line | a two-note interval at a cadence | chords of three, two voices in one hand |
| LH texture | single notes, quarters or slower | a two-note fifth or sixth; a bar of eighths | chords of three, Alberti in eighths, wide arpeggios |
| Span in one hand | within a fifth | a sixth | a seventh, an octave |
| Leaps in a line | steps, thirds, fourths, fifths | sixth to octave, prepared | over an octave between connected notes (a new phrase after a rest or a long note may start anywhere) |
| Range | RH about C4–G5, LH about C3–C4 | one ledger line | clef changes, 8va, two ledger lines |
| Hand positions | five-finger, one move per phrase | a few moves per 8 bars | constant moves, crossing |
| Hands together | one hand moves while the other holds | both in quarters | both in eighths for long |
| Tempo | quarter = 60–112 | up to about 132 | faster |
| Pedal | none | optional | required |
| Length | 8–40 bars (about a minute) | longer song form with repeats | n/a |
## Reading the table when you arrange
- The grade you are asked for is a ceiling for every axis at once, not an average. A piece with a
Grade 2 right hand and a Grade 4 left hand is a Grade 4 piece for that player.
- Three axes decide most arrangements: key (how many sharps or flats), rhythm (shortest value and
syncopation), and the left hand (how many notes at once and how fast). Fix those first.
- Higher grades do not mean "everything"; they mean more things are allowed. A Grade 5 arrangement
of a lullaby can still be a single line over a held bass. Do not add notes just because the grade
allows them: match the character of the source.
- If a requested grade is above Grade 5, say it is the less certain end of this skill: the syllabus
leaves most limits open and our script guards only pedal, clef changes, octave signs and keys.
## Calibration against real piano pieces
PSyllabus (Ramoneda, Lee, Jeong, Valero-Mas, Serra, IEEE TASLP 2025; Zenodo 14794592) is 7,901
solo piano recordings with MIDI and a difficulty level per piece. The levels come from the Piano
Syllabus website (pianosyllabus.com), whose entry for a piece lists the grade each exam board gives it.
We took the 1,271 recordings whose entry carries an ABRSM grade (the site's own community 0–10 rating
is a different scale and was not used) and kept only aggregate percentiles; the data itself is not
copied here. The Zenodo record is marked CC BY 4.0 while its description says research use only, so
we publish numbers derived from it and nothing else. The script compares an arrangement with the
percentiles, as information and a soft warning only (a recording's tempo is a performer's choice).
Notes per second played, both hands, 10th percentile / median / 90th percentile:
| Grade | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 |
| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
| Recordings | 20 | 130 | 139 | 128 | 127 | 127 | 115 | 109 | 156 |
| Notes/s | 1.9 / 4.5 / 6.0 | 2.7 / 4.4 / 7.7 | 3.4 / 5.4 / 8.4 | 3.3 / 5.6 / 8.4 | 3.6 / 6.6 / 10.4 | 3.6 / 6.8 / 10.6 | 3.7 / 6.9 / 11.3 | 4.2 / 7.6 / 11.2 | 4.4 / 7.9 / 12.6 |
| Length (s) | 21 / 41 / 61 | 25 / 37 / 77 | 31 / 48 / 77 | 33 / 55 / 90 | 40 / 70 / 119 | 52 / 95 / 151 | 58 / 98 / 172 | 68 / 132 / 236 | 111 / 201 / 306 |
Read it with care: Grade 0 has only 20 recordings, the median density barely rises between Grades
0 and 3, and transcription from audio adds ghost notes. What it supports: Grade 1 pieces are short
(about 30–45 seconds) and a Grade 8 piece is rarely under two minutes.
## Worked moves
Made-up examples written as bar contents. "Lower grade" means about Grade 1 unless said.
- **Sixteenth arpeggios (Bach-prelude style), one chord per bar.** RH: the top notes of the figure
as a slow melody (E4 half, F4 half, or the top note per beat in quarters); LH: the bass as a
whole note. Or double all values: a bar of sixteenths becomes two bars of eighths in one
five-finger shape. Keep the notes that colour the chord (the E♭ or F♯ over a held bass) in the RH.
- **Alberti bass in eighths (C–G–E–G).** Grade 1: LH quarters C3–G3 (1-5) or a whole-note C3.
Grade 2–3: broken quarter figure; Alberti in eighths from about Grade 3.
- **Pop LH broken chords 1-5-8-10 in eighths.** Grade 1: half notes root then fifth, or a whole-note
root; in the chorus quarters 1-5-1-5. Grade 3: eighth-note 1-5-3-5 fits one hand position.
- **RH melody in octaves or with chord tones under it.** Grade 1–2: the top note only. Grade 3
and up: octaves are fine for a phrase or two.
- **Melody jumping an octave for the chorus.** Keep it in the verse's octave, or move the whole
phrase, never half a phrase.
- **Syncopated melody.** Grade 1–4: on the beat, except the one signature push of the hook, written
eighth, quarter, eighth. From Grade 5 syncopation is allowed.
- **Triplet melody.** Below Grade 6: two eighths or a quarter plus an eighth, first note on the beat.
- **Six flats (G♭ major) or other far keys.** Move to the nearest allowed key (a tritone down to C,
or a semitone up to G), choosing the one that keeps the melody in the comfortable range; say it,
and offer the original key as a harder second version.
- **Waltz LH (oom-pah-pah).** Grade 1: dotted-half bass, or bass on 1 and a held two-note fifth.
Grade 2: bass, then a two-note interval on 2 and 3.
## Going down and going up
- **Down from the target**: Grade 0 is the five-finger version, hands mostly taking turns, quarters
and halves, C major or D minor. Offer it if the learner has played only a few months.
- **Up from the target**: the next version adds exactly the next row of the table: a new key, a
dotted rhythm, hands together, a chord. Say which one you added. A tidy ladder (the same piece at
Grades 1, 3 and 5) is a good deliverable when the user is not sure of the level.
## Self-check by hand
For the chosen grade, go bar by bar and answer: Is any value shorter than allowed? Does either hand
play more notes at once than the table says? Is the left hand busier than the table says? Is any
jump wider than allowed between connected notes? Does any note need more ledger lines than the grade
reads? Does the signature have more accidentals than the grade allows? Then sing the right hand: is
it still the tune? Play right hand and the bass: are the chords still heard?
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| 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: 196k | Updated | Claude CodeCodex | Verified | Install |