riso-score
Scores a riso film or reworks its score. Designs the cue list from the film's FILM.md events, builds a deterministic renderAudio() from the sound kit in studies/sound.html, iterates with tools/audio.mjs, gates determinism, length, loudness and sync, and records measured results in FILM.md. Use for "score this film", "add sound/music", "the climax is too loud", "fix the handoff at 16 s", "check the mix", sound effects, foley or a soundtrack on a riso film. Not for drawing or motion (riso-film) or changing tools/.
sevenevesai · Static checks on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add sevenevesai/riso-windowseat --skill riso-scoreAbout this skill
name: riso-score description: Scores a riso film or reworks its score. Designs the cue list from the film's FILM.md events, builds a deterministic renderAudio() from the sound kit in studies/sound.html, iterates with tools/audio.mjs, gates determinism, length, loudness and sync, and records measured results in FILM.md. Use for "score this film", "add sound/music", "the climax is too loud", "fix the handoff at 16 s", "check the mix", sound effects, foley or a soundtrack on a riso film. Not for drawing or motion (riso-film) or changing tools/.
Riso score
Produce the renderAudio() half of films/<name>/index.html: a deterministic stereo score exactly
the film's duration at 48 kHz, scaled once to −16 LUFS under a −1 dBTP ceiling, with a measured
sheet and a full muxed MP4 reviewed with the picture. Commands run in tools/.
examples.md shows eight finished scores: sampled piano (films/window-seat),
recorded strings timed from the picture (films/roost), found CC0 instruments (films/held),
sampled handpan with edge-timed swells (films/nonpareil), a CC0 trio sharing the picture's
clock (films/eclosion), procedural (films/lumen), procedural from the kit alone with a note
per drawn mark (films/passenger) and two switchable candidates (films/emergence).
Before writing a note
- Read the film's
FILM.mdfor sound direction and timed events, anddocs/sound.mdfor the kit, sync, transitions, mix and how to read the sheet. - Spot the film: list every boundary and visible event with its time and decide whether the music notices it or rides through. Pick three to five true sync points. Choose tempo, mode and one motif from the subject; the project mandates no BPM, key or chord.
- Find the film's event data (cue arrays, reveal starts, contact times). The score reads those, never copied numbers, so retiming the picture retimes the sound.
Stages
Each stage ends with audio.mjs output (seconds to run), not with reasoning about code.
- Kit and skeleton. Copy the
── sound kit ──block fromstudies/sound.htmlafter the film's motion kit; its header lists the names it declares, so rename collisions. WritebuildScore():Score({ duration: DUR, key: '<name>' }),airacross the film,return s.render(). Cache the promise so the player andrenderAudio()share one render;renderAudio()returnswavBase64(buffer). Publish sync points aswindow.__riso.marks.node audio.mjs ../films/<name>/index.html --twicemust show matching length and two equal renders before anything else. - Bed and transitions. Place sustained layers (
pad,organ,wind,rain,air) passage to passage. Bridge each cut on purpose: pre-lap, post-lap, pedal, pivot or texture handoff. Run with--markson the boundaries; a 200 ms hole 10 dB under its surroundings at a cut is the fade-to-silence failure. Fix it before adding foreground. - Foreground and sync. Put
hits on the true sync points so swells peak on the visible arrival; let the rest breathe.--around <t> --window 1per point: onset within ~40 ms after the mark, never more than 20 ms before. Pick material timbres (contact,paper,drop) from what is on screen. - Climax and ending. Prepare the climax with a riser, a low body and staggered accents, not the same voices louder. Decide button, tail or hard out. Check the lift into the climax in the short-term curve.
- Mix. Balance voices, pan by screen
x, keep bass centred;rendersets the level. If the true-peak ceiling pulled the mix under target, fix the peak, not the target. Nothing above 4 kHz in the band percentages means no air.
Gates
After every stage, and once more in Firefox before delivery:
node audio.mjs ../films/<name>/index.html --twice --marks <sync points>
node audio.mjs ../films/<name>/index.html --engine firefox --ffmpeg
FAIL breaks the contract: no renderAudio(), wrong length, clipped samples, or two renders
differing beyond 16-bit jitter (Chromium jitters a step or two; Firefox is byte-identical).
WARN is a judgement to resolve or record: level more than 1 LU off −16 LUFS, true peak above
−1 dBTP, a rate other than 48 kHz, an opening or ending above −40 dBFS in its first or last
10 ms. Discontinuities are bugs at note starts and expected at designed ticks. Then read
out/<name>/_audio.png: waveform lanes, log spectrogram, loudness against the target band with
valleys marked, and the per-mark table.
Delivery
node render.mjs ../films/<name>/index.html --fps 30 --size 1080 --engine firefox
Only the full export carries the score; render.mjs prints the muxed loudness and true peak.
When only the score changed, remux instead of re-rendering every frame: take the Firefox WAV that
audio.mjs --engine firefox writes to out/<name>.wav, then
ffmpeg -i ../out/<name>.mp4 -i ../out/<name>.wav -map 0:v -map 1:a -c:v copy -c:a aac -b:a 192k -shortest -movflags +faststart ../out/<name>-rescored.mp4
ffmpeg -i ../out/<name>-rescored.mp4 -af ebur128=peak=true -f null -
and read the true peak from the second command, as render.mjs would. Listen through quiet
passages, every handoff and the climax with the picture. If you cannot listen, say so, leave
perceptual quality unclaimed and name three to five times for the user to hear: passing meters did
not stop a modal piano sounding like MIDI to a human listener.
Record under ## Score in FILM.md: direction, tempo/grid and mode, each sync event and what
sounds on it, deliberate silences, the measured line (I −16.0 LUFS, LRA 3.7 LU, TP −2.0 dBTP, clipped 0, firefox byte-identical), the marks table, and what was heard or that nothing was.
Recorded samples need a license that permits redistribution, pinned sources and attribution
beside the film (see films/window-seat/AUDIO-SOURCES.md, CC BY, and
films/roost/AUDIO-SOURCES.md, CC0). Libraries disagree on octave