Music Composition

A comprehensive composition skill covering music theory and compositional craft for both DAW-based and acoustic/score-based workflows. This skill does NOT handle DAW automation, MIDI generation, audio engineering, or notation software — those belong to other skills.

Core philosophy

Composition is a series of decisions, not a list of rules to follow. When advising:

• Frame techniques as options, not commandments. A "rule" in voice-leading is a probability distribution that creates a certain sound. Breaking it makes a different sound, which may be exactly what's wanted. Always know which sound the user is after.
• Explain why a technique produces its effect. Cite the perceptual or contextual reason — "the leading tone resolves up because the half-step gravity is strong and the ear expects closure". This lets the user reason about novel situations rather than memorize rules.
• When the user describes a feeling or goal, give multiple options. "I want this to feel uneasy" has many valid solutions (tritone substitution, modal mixture, polychords, rhythmic displacement). Offer 2–4 with their trade-offs rather than picking one.
• Be concrete. "Try a iv chord" beats "try modal mixture." "Voice this with the 3rd on top in close position, low E in the bass" beats "make it tighter." Always give the user something they can play.
• Respect genre conventions but don't be enslaved by them. A "wrong" choice in jazz might be perfect in indie rock. Always know which genre frame the user is operating in.
• When the user describes a vague creative problem, translate it before answering. "The chorus feels weak" decomposes into: melodic range, harmonic surprise, dynamic contrast, arrangement density, rhythmic activity, lyric/syllable density. Diagnose, then prescribe.
• Don't moralize about technique. Parallel fifths aren't immoral. They're a sound. Bach avoided them; Debussy used them; the user's track might want them.

What this skill does NOT cover

• DAW operation — keyboard shortcuts, plugin parameters, automation lanes (separate skill).
• MIDI file generation or direct manipulation — handled elsewhere.
• Audio engineering / mixing / mastering / sound design — frequency-aware composition is in production-aware/, but EQ, compression, and synthesis decisions are out of scope.
• Music history trivia unconnected to composition technique. (Stylistic conventions of a period ARE in scope.)
• Music notation software operation (Sibelius, Finale, Dorico, MuseScore UI).
• Performance pedagogy or instrumental exercise routines for becoming a player. Composition-facing playability and idiomatic writing are in references/instrument-idiom/, but this skill does not replace a private teacher, method book, or technique practice plan.

Navigation

The bulk of this skill lives in references/. Always start by reading references/00-navigation.md — it maps user requests to the specific reference files you need.

Don't load every reference. Load only what's directly relevant to the current question. For most requests, 1–3 reference files is enough. If you would need 5+, the question is too broad — narrow it first, or pick the dominant aspect and answer that.

For quick lookups (chord progression catalogs, mode formulas, voicing libraries), check assets/. Asset files are short and can be quoted directly. Reference files should be synthesized, not quoted.

Top-level structure

references/
├── 00-navigation.md              ← Read this first, every time
├── fundamentals/                 ← Pitch, intervals, scales, rhythm, notation, prosody
├── harmony/                      ← Chords, voice leading, modulation, jazz, modal, reharm
├── melody/                       ← Construction, motivic development, phrase structure
├── counterpoint.md               ← Species → tonal → fugue
├── rhythm-groove/                ← Rhythmic devices, groove/feel, odd meters
├── form/                         ← Classical & popular forms, narrative
├── orchestration/                ← Instruments, voicing, texture, density, choral writing
├── instrument-idiom/             ← Composition-facing playability for piano, guitar, bass, drums, strings, winds, brass, vocals
├── genres/                       ← Per-genre conventions (incl. Korean traditional, C-pop / SE Asian, Latin, Afrobeats, MENA, South Asian, country, metal, gospel, Brazilian, game, media/commercial)
├── songwriting/                  ← Lyrics, hooks, topline
├── analysis.md                   ← Roman numeral, form, Schenker, set theory
├── techniques/                   ← Theme & variation, 20th C., constraint-based, microtonal, algorithmic / AI-assisted
├── production-aware/             ← Pre-production, composition-mix interface, energy
├── research/                     ← Web trends, user listening context, regional trend evolution, reference digging, style/copyright guardrails
├── creative-workflows/           ← Musical brainstorming, answer calibration, revision loops, and user-agent collaboration patterns
├── validation/                   ← Release readiness, Phase B/C records, RC packaging, and prompt smoke tests
├── source-bibliography.md        ← Maintainer-facing source map and verification guide
├── workflow.md                   ← Starting, revising, hybrid-genre advising
├── critique-and-feedback.md      ← Evaluating user's existing work (critique mode)
└── teaching-composition.md       ← Pedagogy mode, learning paths, exercises

scripts/
└── music_theory_sanity_check.py   ← Optional validation and regression helper for maintainers

assets/
├── progressions-catalog.md
├── response-templates.md
├── diagnostic-checklists.md
├── trend-and-reference-matrices.md
├── musical-brainstorming-cards.md
├── session-brief-and-decision-log.md
├── web-search-cheatsheet.md
├── chord-symbol-ambiguity-and-parsing.md
├── scale-degree-spelling-cheatsheet.md
├── music-theory-audit-rubric.md
├── cadence-reference.md
├── modes-cheatsheet.md
├── intervals-and-scale-formulas.md
├── jazz-voicings.md
├── form-templates.md
└── chord-symbol-conventions.md

Typical response workflow

1. Identify the user's actual ask. Surface goal (e.g., "write a sad chord progression in C") and underlying goal (e.g., "I want emotional weight without sounding cliché"). They're often different.
2. Identify the genre frame. A "sad chord progression" means very different things in chamber music, neo-soul, lo-fi hip-hop, and K-pop ballad. If unstated and ambiguous, ask. If implied, work with it but name the assumption.
3. Read references/00-navigation.md to find the relevant reference files.
4. Load the minimal set of reference files needed.
5. Translate theory into concrete options. Don't dump theory — produce 2–4 actionable suggestions with brief rationale and a clear sample (chord names, notes, rhythm).
6. Note adjacent considerations the user may not have thought of (e.g., "this works in C, but if you modulate to the relative minor at the bridge, you open up iv–i–V–i, which is darker still").
7. Stop before over-explaining. A concise, useful answer beats a comprehensive lecture.

Notation conventions

Use these consistently throughout the skill:

• Chord symbols (lead-sheet / jazz style): Cmaj7, Dm7, G7♭9, F♯dim7, B♭/D (slash chord), Cmaj7♯11.
• Roman numerals: capital = major triad, lowercase = minor; ° = diminished, + = augmented; arabic for inversions and 7ths (I, vi, V7, ii⁶, V⁶/⁵, vii°⁷, iiø7); ♭ and ♯ prefix for chromatic alterations of scale degree (♭VI, ♯iv°); / for tonicization (V/V, V7/vi).
• Pitches: scientific pitch notation when register matters (C4 = middle C); plain letter names when unambiguous. Sharp = ♯, flat = ♭, double-sharp = 𝄪, double-flat = 𝄫.
• Intervals: m2 M2 m3 M3 P4 A4 d5 P5 m6 M6 m7 M7 P8; "tritone" acceptable when style is informal.
• **Scale degree