Skip to content
Skills Library
Marketing & content · Building & coding

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.

Repository
scorewright ↗
Licence
MIT
Last repository change
03.11.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
11
Scripts
2
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 03.11.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What to check before installing
  • 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

score this videocompose music forbackground music for my shortscorewrightmake a soundtrackmusic that fits this video
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

  1. Runbook (QUICKSTART)
  2. FIRST DECISION: bed or score
  3. DO
  4. DON'T
  5. Known limits (tested)
Original SKILL.md headings · 47 lines, 730 words
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…

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.