scorewright
/scorewright
Compose and produce an original film score for a video - watch and spot the video, choose a musical identity (genre, key/mode, BPM, instruments, leitmotif), write a score.json, render real instruments (FluidSynth + GeneralUser GS samples, audio-as-code synths, sound design), mix it under the narration (ducking + speech dip, bed X LU under the voice) and deliver stems, MIDI, previews and QC. Use for "score this video", "compose music for", "background music for my short", "scorewright", "make a soundtrack", "music that fits this video", or any request for original music timed to a video.
- Author
- jayaprakash-pixel ↗
- Repository
- scorewright ↗
- Licence
- MIT
- Last repository change
- 03.11.2026
Assessment and security
- Files in this package
- 11
- Scripts
- 2
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
- 2 scripts in this package. Review them before installing, as Claude may execute them.
Scripts: scripts/scorewright.py, scripts/test_theory.py
What it does and when to use it
Compose and produce an original film score for a video - watch and spot the video, choose a musical identity (genre, key/mode, BPM, instruments, leitmotif), write a score.json, render real instruments (FluidSynth + GeneralUser GS samples, audio-as-code synths, sound design), mix it under the narration (ducking + speech dip, bed X LU under the voice) and deliver stems, MIDI, previews and QC. Use for "score this video", "compose music for", "background music for my short", "scorewright", "make a soundtrack", "music that fits this video", or any request for original music timed to a video.
Triggers from the description
Original author description
Compose and produce an original film score for a video - watch and spot the video, choose a musical identity (genre, key/mode, BPM, instruments, leitmotif), write a score.json, render real instruments (FluidSynth + GeneralUser GS samples, audio-as-code synths, sound design), mix it under the narration (ducking + speech dip, bed X LU under the voice) and deliver stems, MIDI, previews and QC. Use for "score this video", "compose music for", "background music for my short", "scorewright", "make a soundtrack", "music that fits this video", or any request for original music timed to a video.
How it works
- Runbook (QUICKSTART)
- FIRST DECISION: bed or score
- DO
- DON'T
- Known limits (tested)
SKILL.md preview
--- name: scorewright description: Compose and produce an original film score for a video - watch and spot the video, choose a musical identity (genre, key/mode, BPM, instruments, leitmotif), write a score.json, render real instruments (FluidSynth + GeneralUser GS samples, audio-as-code synths, sound design), mix it under the narration (ducking + speech dip, bed X LU under the voice) and deliver stems, MIDI, previews and QC. Use for "score this video", "compose music for", "background music for my short", "scorewright", "make a soundtrack", "music that fits this video", or any request for original music timed to a video. --- # Scorewright - Claude composes, the tools render **Rule zero:** Claude makes every creative decision in `score.json` and writes the reason (`direction`, cue `why`). The script has no default style, BPM, key or progression. Never reuse the last score as a template; start from the video. `PY` = a Python 3.10+ with `requirements.txt` installed. `SW` = `<this folder>/scripts/scorewright.py`. Before the first render on a machine, run `PY SW doctor`. If it says `MISSING`, follow `README.md` > Install, then stop and tell the user. ## Runbook (QUICKSTART) | # | Step | Command / action | Done when | |---|---|---|---| | 0 | Check | `PY SW doctor` | prints `ready` | | 1 | Facts | `PY SW analyze <video> <work> --words <words.json>` (or `--voice`) | `facts.json` (duration, cuts, speech regions, timed words) + `contact.jpg` | | 2 | Watch | Read `contact.jpg` (tile i = t i*step) and the timed words; read the script/storyboard if any | You can state message, audience feeling, emotional arc | | 3 | Spot | Write a spotting table: cue in/out, hit points (word times, reveals, turns), where silence is better, emotion per section (dominant + secondary + intensity) | Every cue start/hit is a measured time | | 4 | Direction | Choose identity with reasons: genre blend, key/mode, BPM per cue, palette, leitmotif (+ how it transforms), dynamic arc. Use `references/craft.md` | Written into `direction` | | 5 | Score | Write `score.json` (`references/score-format.md`, example `examples/bed_demo.json`). Start each cue ON its hit point; use `s:<sec>` to place notes on words; `PY SW fit <times>` only to test one tempo inside a cue | Valid JSON | | 6 | Render | `PY SW render score.json <out>` | stems, full, no_percussion, composition.mid, previews, SCORE_NOTES.md, qc.json, spectrogram.png | | 7 | QC | Read `qc.json` + `spectrogram.png`; fix and re-render (new out folder per version) | all `checks` true; every hit `rise_db` >= 3; no unintended silences | | 8 | Listen | The user listens to `preview_with_voice.mp3`. Claude cannot hear: say so, report the numbers, ask what to change | User approves | | 9 | Deliver | Hand `full_soundtrack.wav` (already X LU under the raw voice, drop in at 0 dB) or the stems to the user's editor | - | ## FIRST DECISION: bed or score - **Explainer / narrated video (speech nearly continuous) = BED.** No melody, no leitmotif, no tune under speech. Use pulse, texture, slow harmony, sub only. Energy changes at section borders; 2-3 hits/drop-outs on real reveals; identity comes from timbre/rhythm, not a tune. A short tune only where there is NO speech (intro before the first word, last 1-2 s after the final word). - **Film / documentary with real speech-free stretches = SCORE.** Leitmotif and melody live in those gaps. - A melody under explanation is a second voice: the viewer must choose, and the explanation loses. ## DO - Silence, restraint and contrast are tools. Not every video needs music everywhere. - One leitmotif per core idea; develop it (invert, augment, reharmonise, change one note) at story turns. - Reduce density under dense explanation; let music speak in speech gaps and on visual-only moments. - Engine choice per track: `gm` for acoustic realism (piano, strings, brass, winds, choir, mallets), `aac` for synths / sound-designed voices (slow: ~10x gm; use for few, sparse tracks; optional), `sfx` for impacts/swells/sub drops on hit points. - Bed `bed_lu_under_voice` 11 (energetic) to 12.6 (calm), measured in speech regions - the script sets it exactly. - New version = new out folder; never overwrite an approved render. ## DON'T - No swish / whoosh / page-flip sound. `riser`/`swell` are tonal swells, use sparingly. - No copied melodies, recognisable themes or reference-track arrangements. - No same BPM/key/progression for every video; no loudness as a stand-in for emotion. - No SFX without a visual or story reason; no SFX louder than narration. ## Known limits (tested) - GM SoundFont orchestra = good mock-up, not Spitfire/Kontakt realism. Solo piano, pads, plucks, pizzicato and synths hold up best. - One tempo per cue (tempo change = new cue). composition.mid uses absolute time with the first cue's tempo. - audio-as-code render is slow (all-aac 76 s score: about 8 min on a Ryzen 5 5600H; mixed score: about 50 s). - Claude cannot listen; QC numbers + spectrogram + user ears are the loop.
Files in this package (11)
- .gitignore 1 KB
- LICENSE 1 KB
- README.md 6 KB
- SKILL.md 5 KB
- config.example.json 1 KB
- requirements.txt 1 KB
- examples/bed_demo.json 3 KB
- references/craft.md 7 KB
- references/score-format.md 5 KB
- scripts/scorewright.py 33 KB
- scripts/test_theory.py 1 KB
Versions
The database has no other skills named scorewright.
Database snapshot: 13.11.2026 · package version 460c473f10bb (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100video-to-music
Score a video with original music using Sonilo — the model watches the cut and matches pacing, motion, and emotion, returning either the audio or a new video with the score muxed in. Use when the user has a finished video that needs a soundtrack. Every track is licensed and… - 90score-and-voice
Add music and voice to NovaField films - generate a score or song with an audio workflow, narration or voice-over with a text-to-speech workflow, and lay it over the cut with the right timing and mix. Use when the person wants music, a score, a jingle, narration, voice-over, a… - 100audio-mixing
Mix voiceover, background music and sound effects for video - ducking music under speech, fades, loudness normalization (LUFS), noise reduction and music selection. Use when audio sounds uneven, music overpowers speech, or the user asks to add or balance music. - 100abc2wav
Compose music by writing an ABC notation score and render it to a mixed, mastered 16-bit stereo WAV (piano, strings, synths, drum kits, risers and hits) with Node only. Use when the user wants a soundtrack, a jingle, a launch-video cue, background music for a demo, or wants to… - 100video-audio-design
Use this skill when adding audio to programmatic videos - generating narration with ElevenLabs TTS, sourcing royalty-free background music, creating SFX with FFmpeg, implementing audio ducking, or mixing multiple audio layers in Remotion. Triggers on ElevenLabs, text-to-speech,… - 100soundtrack
This skill should be used when the user asks to "add music to the animation", "make the music in code", "synthesize a soundtrack", "compose background music that fits the cuts", "sync the music to the video", "check if the audio lines up with the picture", or "the music is too…