Communitygithub.com

film-sound

Add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

What is film-sound?

film-sound is a Cursor agent skill that add sound to a finished product-film picture with real recorded sound effects (CC0 packs such as Kenney's) placed only on real on-screen events, decide with the owner whether there's a music bed, mix to -14 LUFS and mux into the renders without re-rendering. Stage 4 of product-film. Use when a film's picture is approved and needs sound effects or music, or when the owner says the sounds feel fake, synthetic or "AI slop".

Works with~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/aqeelshamz/product-film-skills/tree/HEAD/film-sound

Ask in your favorite AI

Open a new chat with this agent skill pre-loaded.

Documentation

Film sound

"The SFX sounds like absolute AI slop" was said about synthesized beeps, whooshes and ticks on every cut. What the owner then approved: real recordings, sparse, only where something actually happens on screen.

Choices to put to the owner first

From product-film/references/question-bank.md › Sound: sound-effect density (sparse real / rich foley / none) and music (dry / soft bed / music-led with a drop). Recommend sparse real + dry for a product demo with a voiceover. Don't assume music.

Rules

  • Real recordings only. Kenney CC0 packs work well: UI Audio, Interface Sounds, Impact Sounds, Digital Audio (sparingly). Credit them in assets/CREDITS.md even though CC0.
  • About 20 cues in 60 s, each on a real event: a cursor click, a send, a widget landing, a key moment, the logo.
  • Never: a tick on every typed letter, a whoosh on every camera move, a riser into everything, stacked hits.
  • Quiet: cues sit under the voice (mix sfx around -10 dB vs voice 0); gain per cue 0.2–0.5. Repeated events vary (different click files, ±small gain) so they don't sound machine-made.
  • Timing: cues land on the visual onset (the frame where the widget lands), not the start of its move. A click sound lands on the cursor's dip.

Steps

  1. Get the packs. Kenney blocks curl (403). In the browser on kenney.nl, run in the page: fetch('https://kenney.nl/download-link/' + hex('assets/<pack-slug>')), where hex hex-encodes the string ([...s].map(c => c.charCodeAt(0).toString(16).padStart(2,'0')).join(''); if it fails, read how the page's own download button builds the link). That returns a signed link; download, unzip into its own new folder, copy the chosen .ogg files to assets/sfx/. You can't hear audio: pick by file name and pack purpose, and say so.
  2. Get event times in video seconds (after the pacing warp): node tools/probe.mjs cuts, plus node tools/probe.mjs "window.UNWARP(<story time>)" for events inside shots.
  3. Write cues in timeline.json › samples: { "at": <video seconds × 2>, "file": "click_002.ogg", "gain": 0.35, "what": "cursor clicks Send" }. The what is required: it's how the owner reviews the list.
  4. Render the sound: node scripts/sync.mjs && python3 scripts/sfx_samples.py && python3 scripts/mix.py (no audio/music.wav → mix.py makes silence and sets music to -100). Target -14 LUFS, ≤ -1 dBTP.
  5. Mux into the existing render: node scripts/render.mjs --mux [--fmt 9x16]. No re-render needed.
  6. Review gate. Send the MP4 and the cue list (time · sound · event). Say plainly that you can't hear it and ask about level, density and any cue that feels fake. Wait for approval.

When the picture's timing changes later

Re-probe, move every cue, re-run steps 4–5. Cues drift silently when the warp changes.

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

film-build

Build a product film in code as a deterministic seek(t) web page (real product UI, real OS chrome, kinetic text, typed prompts, a cursor, morphs and camera moves), review it as stills and drafts, render it at 60 fps with motion blur, and adapt it to 9:16 without changing 16:9. Ships a project kit (init.sh, film engine, render/sync/probe/sheet/regression tools). Stage 3 and 6 of product-film. Use when building, fixing or rendering the picture of a launch/promo film, or making its vertical version.

film-storyboard

Write the story of a product film as beats (what the viewer sees, the words on screen, the voice, the sound, why the beat exists, and where each claim is proven) and send it to the owner as a one-page storyboard with frames for review, with 2–4 directions when the story is open. Stage 2 of product-film, and the review format reused for the voiceover. Use when planning a launch/promo film's story, shot list, or script, or when the owner says "give me a storyboard", "give me directions", "I'll review and decide".

film-voiceover

Write, review, test and record the voiceover for a product film after its picture is approved, as a script on a storyboard of the film's real frames, with directions to choose from, an eyes-closed coherence check, a pronunciation test for the product name, TTS recording per section (Fish Audio), phrase placement on the film's timeline, mixing and muxing. Stage 5 of product-film. Use when a launch/promo film needs narration, or the owner says the voiceover sounds like AI, doesn't match the frames, or mispronounces the name.

product-film

Make a product launch / promo / explainer film that sells and does not look or sound AI-made, through review gates the owner signs off one at a time. Study a reference video for its grammar (never copy it), then storyboard, build the film in code, add sound, write and record the voiceover, and deliver 16:9 and 9:16. Use when someone wants a launch video, promo, product film, explainer, ad, "a video like this one" for their product, or says the last video looked like "AI slop" or "vibe coded". Entry point for the film-* skills (film-reference-study, film-storyboard, film-build, film-sound, film-voiceover).

Related Skills