calesthio/music-supervision-scoring
Provider-independent music supervision and scoring direction for AI agents producing generated videos, ads, trailers, explainers, product films, social clips, documentaries, game trailers, and branded content. Use when planning, prompting, selecting, licensing, mixing, repairing, or quality-reviewing music, score, temp tracks, needle drops, AI-generated tracks, cue sheets, stems, loudness, loopability, platform music constraints, and rights-aware audio handoff for visual media.
npx skills add https://github.com/calesthio/generative-media-skills --skill music-supervision-scoring
Treat music as a production decision, not decoration. A strong music plan explains what the audience should feel, where music should enter and leave, what rights path is safe, how the cue will survive edit changes, and how the final mix will protect speech, captions, audio description, and delivery specs.
Use this skill to produce a music supervision plan, score brief, licensed-track shortlist, AI-music prompt, cue sheet draft, mix handoff, or music QA review for audiovisual work.
Use these labels when making claims or giving recommendations:
Do not turn a heuristic into a rule. For example, "trailer drums should always rise" is weak; "this trailer's second act needs rhythmic acceleration because the edit compresses from 3-second shots to 0.8-second shots" is useful.
Before choosing music, answer these production questions:
Documented fact, verified 2026-07-10: a music supervisor's professional role includes shaping musical vision, tone, and style with the creative team. Source: Guild of Music Supervisors, https://www.guildofmusicsupervisors.com/what-is-a-music-supervisor
Create a spotting map before prompting or licensing. For every cue, capture:
| Field | What to decide |
|---|---|
| Cue ID | Stable number such as M01, M02, M03; do not renumber casually after revisions. |
| Timecode | In, out, duration, and edit lock status. |
| Cue type | Score, source/diegetic, licensed song, trailerized hit, bumper, logo sting, loop, silence. |
| Dramatic job | Tension, release, irony, credibility, intimacy, propulsion, reveal, memory, transition, button. |
| Sync points | Words, cuts, camera moves, title reveals, product moments, jokes, impacts, game mechanics. |
| Emotional change | Start state, turn, end state; avoid one static mood over a dynamic scene. |
| Avoid list | Genres, cliches, emotional overstatement, cultural mismatches, temp-track traps, legal risks. |
| Handoff | Stems, bars/beats, loop point, fade handles, alt ending, ducking notes. |
Production heuristics:
Empirical observation to make after reviewing the edit: identify where music is fighting a spoken keyword, visual gag, product sound, or accessibility narration. Repair by thinning arrangement, moving the cue, changing register, reducing side energy, or using silence.
Temp tracks are useful for communicating energy, density, contour, and editorial rhythm. They are dangerous when the team becomes attached to an uncleared track, a famous artist identity, or a specific melody.
When using a temp, translate it into attributes:
Never ask an AI music generator or composer for a track "like" a named living artist, a specific copyrighted song, or a recognizable recording. Request musical attributes instead.
Use for bespoke emotional arc, recurring themes, precise sync, brand ownership, unusual structure, or edit flexibility. Specify:
Use when the cultural meaning, lyric, artist voice, or era of an existing recording is essential. Require rights clearance before final use. Avoid using a recognizable temp as if clearance is guaranteed.
Documented fact, verified 2026-07-10: in U.S. copyright guidance, a musical work and a sound recording are separate copyright-protected works and are commonly owned/licensed separately. Source: U.S. Copyright Office, https://www.copyright.gov/engage/musicians/
Production implication: a commercial recording normally requires clearing the composition/publishing side and the master recording side. If the plan uses a cover or re-record, the master clearance changes, but composition rights still need attention. Consult qualified counsel or a music clearance professional for legal decisions.
Use when budget, schedule, or licensing simplicity matters more than uniqueness. Check license scope: platform, media type, territory, duration, paid ads, organic posts, client work, broadcast, sublicensing, editing, and attribution.
Documented facts, verified 2026-07-10:
Production implication: a track that is safe inside one platform library may not be safe for another platform, an offline ad, a TV buy, a trade-show booth, or a client's website. Do not assume portability.
Use when the project needs custom timing, many variations, no famous-artist dependency, rapid drafts, loops, or stem-based iteration. Treat provider terms and output rights as volatile.
Documented facts, verified 2026-07-10:
Production implication: verify the active provider plan, commercial scope, prohibited prompts, indemnity, attribution, retention, similarity, and output terms on the generation date. Preserve prompt, settings, seed if used, model/provider version if available, generation timestamp, and license/terms snapshot.
A good AI music prompt is a score brief with constraints. Include:
Example: 30-second SaaS launch ad underscore
Intent: confident product launch under narration, not a hype trailer.
Prompt:
"Create a 30-second instrumental underscore for a B2B SaaS launch video. Structure: 0:00-0:05 quiet tactile pulse and soft piano motif for the problem statement; 0:05-0:18 add warm analog bass, muted kick, and subtle arpeggiated synth for workflow momentum; 0:18-0:26 lift with restrained strings and brighter harmony as the product UI resolves; 0:26-0:30 clean logo button with a short two-note motif and natural tail. Tempo 104 BPM, 4/4, modern premium minimal, warm, precise, optimistic but not childish. Keep 1-4 kHz sparse for narration intelligibility, no vocals, no whistling, no celebrity/artist references, no recognizable song imitation. Provide a full mix and, if possible, drums, harmonic bed, lead motif, and bass stems."
Why it works: it maps the edit arc, leaves room for voice, requests a reusable motif, and avoids risky soundalike language.
Example: documentary transition cue
Intent: move from archival loss to cautious present-day hope without manipulating the audience.
Prompt:
"Compose a 52-second instrumental documentary cue. Emotional arc: unresolved grief at the start, patient curiosity in the middle, small humane lift at the end. Instrumentation: felt piano, low cello harmonics, faint room tone-like granular texture, no drums until a very soft pulse after 0:32. Structure: 0:00-0:14 sparse piano notes with long decays; 0:14-0:32 cello enters and harmony stays suspended; 0:32-0:46 introduce a quiet heartbeat-like pulse; 0:46-0:52 cadence upward without full resolution for transition. Avoid melodrama, trailer impacts, heroic brass, and sentimental pop progressions. Mix should sit below interview dialogue and permit audio description gaps."
Why it works: it scores the ethical stance, not just the sadness.
Example: game trailer act map
Intent: 75-second action trailer with loopable gameplay bed and final logo hit.
Direction:
| Time | Music direction |
|---|---|
| 0:00-0:10 | World identity: processed bowed metal, distant choir pad, no drums. |
| 0:10-0:28 | Mechanics reveal: 140 BPM hybrid percussion, short bass ostinato, hits on UI ability reveals. |
| 0:28-0:48 | Combat escalation: add taiko-like low drums, distorted synth pulses, risers into match cuts. |
| 0:48-1:06 | Boss reveal: drop to half-time, brass/synth motif states antagonist interval. |
| 1:06-1:15 | Logo/button: full ensemble hit, 1-second silence, dry final sting. |
Music request:
"Create a 75-second instrumental hybrid action trailer cue following the act map above. No vocals. Keep the middle combat section loopable from 0:28-0:48 with a clean bar-aligned loop point. Avoid copyrighted franchise references, named composers, and recognizable game themes. Deliver full mix, percussion stem, synth/bass stem, tonal/orchestral stem, risers/hits stem, and final sting if supported."
Draft cue sheet data as the music plan becomes real. Do not wait until the final export if many cues are changing.
Documented fact, verified 2026-07-10: BMI describes cue sheets as a primary way PROs track music in film/TV and lists fields such as title, air date, music length, production company, cue title, composer, publisher, PRO, timing, and usage. Source: https://www.bmi.com/creators/detail/what_is_a_cue_sheet
Documented fact, verified 2026-07-10: ASCAP describes cue sheets as schedules of music in film/TV and points to RapidCue as a standardized digital submission format developed with BMI. Source: https://www.ascap.com/help/royalties-and-payment/cue-sheets
Minimum cue log for an AI agent to maintain:
| Field | Notes |
|---|---|
| Production title/version | Include episode/ad/cutdown variant if applicable. |
| Cue ID and title | Stable ID plus human-readable title. |
| Source | Original score, AI-generated, library, licensed master, public domain, client-supplied. |
| Writer/composer/publisher/PRO | Include "unknown/pending" rather than guessing. |
| Recording owner/master info | Required for needle drops and many libraries. |
| ISRC/ISWC/IPI/CAE | Include when available; do not invent. |
| In/out/duration | Use final picture timecode. |
| Usage type | Background, feature, theme, visual vocal, source/diegetic, logo, promo, etc. |
| Rights notes | License scope, attribution, restrictions, platform, term, territory. |
| Asset path/version | Exact file used in the final mix. |
For each approved cue, hand off:
Production heuristics for dialogue-first video:
Documented facts:
Production heuristics:
Documented facts, verified 2026-07-10:
Production implications:
When music is "wrong," diagnose before regenerating:
| Symptom | Likely cause | Repair |
|---|---|---|
| Feels cheesy | Over-explicit emotion, generic harmony, too many trailer devices | Reduce arrangement, change harmony, score subtext, use silence. |
| Fights VO | Busy lead, vocal layer, same frequency range as speech | Remove vocals/lead, lower density, duck around keywords, rewrite prompt for narration space. |
| Misses edit | No spotting map, wrong tempo, no sync points | Add timecoded hits and structure; request bar-aligned sections. |
| Sounds like a famous track | Temp-love or soundalike prompt | Translate to neutral attributes; change melody, instrumentation, rhythm, and references. |
| Loop clicks or drifts | Non-bar loop, reverb tail mismatch, tempo instability | Ask for loopable bed with clean bar boundary; crossfade; separate tail. |
| Rights unclear | Missing source/license data | Stop final use; request documentation or replace with cleared/original/generated music. |
| Mix pumps | Over-limiting or aggressive sidechain | Rebalance stems, lower limiter input, automate manually around dialogue. |
Before final delivery, verify:
Key sources independently checked for this skill:
Take calesthio/music-supervision-scoring from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.