code-game-trailer
Skill34 starsChanged 8 months agoMITView on GitHub
Turn a browser game or three.js / WebGL scene an agent built into a cinematic trailer MP4: a virtual clock injected before the page's scripts makes every frame exact at 30 or 60 fps, a director JSON scripts each shot (key and mouse inputs, game setup, trailer camera paths, slow motion, HTML titles and end cards), headless Chrome captures 1920x1080 frames, ffmpeg cuts them on the beat, a music bed (code-written or from varg) is normalised to -14 LUFS, and a checker measures frozen frames, loudness, debug text, third-party names and claims. Includes a tested example game. Use when someone asks for a game trailer, to record my three.js game, a gameplay video, a trailer for my browser game, a Fable 5.2 game video or a fake AAA gameplay trailer. Not for HTML motion graphics (hyperframes), 3D previz for AI video (threejs-animatic), AI-generated footage (varg-ai) or editing existing footage (short-form-ffmpeg-cookbook).
- Reads credentials
In this repository85 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- ad-creative-testingSkill
- ai-ad-compliance-checkSkill
- ai-parody-videoSkill
- ai-ugc-ad-videoSkill
- app-ui-mockupsSkill
- blender-code-filmSkill
- caption-stylesSkill
- character-passportSkill
- code-3d-explainerSkill
- code-path-traced-filmSkill
- code-to-video-previzSkill
- ecommerce-video-adsSkill
- ecommerce-video-editSkill
- edit-footage-with-codeSkill
- find-movie-clipsSkill
- find-referencesSkill
- footage-effectsSkill
- gpt-image-2-6Skill
- gpt-image-gifSkill
- gpt-image-markup-editSkill
- gpt-image-sprite-sheetSkill
- gpt-image-sticker-packSkill
- how-to-make-ai-videoSkill
- kinetic-type-artSkill
- kling-4-action-montageSkill
- kling-4-keyframe-filmSkill
- kling-4-promptingSkill
- make-a-woke-profile-with-chatgptSkill
- maps-and-data-motionSkill
- media-downloadSkill
- media-judgeSkill
- model-split-screenSkill
- motion-formatsSkill
- multi-angle-monologueSkill
- paper-shadersSkill
- product-photo-to-videoSkill
- product-video-hooksSkill
- scene-recast-videoSkill
- short-form-ffmpeg-cookbookSkill
- social-overlaysSkill
- stickman-videoSkill
- threejs-animaticSkill
- tiktok-shop-videoSkill
- title-designSkill
- transition-craftSkill
- varg-ad-library-remixSkill
- varg-ad-localizeSkill
- varg-ad-variantsSkill
- varg-aiSkill
- varg-birthday-videoSkill
- varg-character-absurdSkill
- varg-character-beautiful-womanSkill
- varg-character-big-guySkill
- varg-character-cartoonSkill
- varg-character-cringeSkill
- varg-character-designSkill
- varg-character-fitnessSkill
- The first 60 shown.
The file
We split this skill into the rules it gives an agent
5 rules. About 0 are common, 2 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈2
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Very specific: line 86
All motion from requestAnimationFrame time or performance.now() deltas (the clock controls both).
- Distinctive: line 94
Write it before any camera work.
- Very specific: line 128
Every shot is a fresh page load (deterministic start), then setup, then warmup seconds stepped without recording, then the frames.
- Distinctive: line 188
Before anyone sees it:
- Very specific: line 228
Plan inputs, do not guess them: Read the layout from the page (__game.layout), then try timings: a grid of 486 key timings ran in 61 s (90 …
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Code game trailer: record the game, cut it like a trailer
On launch day of Claude Fable 5.2 (2026-11-09) the most-watched thing people made with it was a browser game built from one brief: 3.45M views across 18 posts. What travelled was not the game but the video of the game. A screen recording of a game drops frames, drifts from the music and shows a cursor and a debug counter. A trailer needs exact frames, chosen moments, a camera that moves like a film camera, a title, a beat and an end card. This skill does that for any HTML/WebGL game an agent wrote.
The example in examples/lantern-canyon/ (an original game made for this skill, one HTML file) went
from director JSON to an 18.6 s 1080p trailer in 56 s on a laptop (stills, capture, score, cut and check), with
no credits spent: the full trailer
(1920×1080, 19 MB). Your own runs write it to examples/<game>/master.mp4.
When to use it
| request | use |
| "make a trailer / gameplay video of my browser game", "record my three.js game" | this skill |
| a game that does not exist yet ("make a game and a trailer for it") | brief the game first ("Making the game in the first place" below), then this skill |
| the video is HTML motion graphics, captions, a launch film | hyperframes |
| a 3D grey-box previz that will feed Seedance video-to-video | threejs-animatic |
| footage from AI video models | varg-ai |
| cutting, captioning or reformatting existing footage | short-form-ffmpeg-cookbook |
Quick start
S=<this skill>
bun $S/scripts/capture.ts $S/examples/lantern-canyon/director.json --stills # 3 stills per shot, ~6 s: LOOK at them
bun $S/scripts/capture.ts $S/examples/lantern-canyon/director.json # all frames -> examples/lantern-canyon/capture/
bun $S/scripts/score.ts $S/examples/lantern-canyon/director.json # music.wav + sfx.wav (written in code, free)
bun $S/scripts/cut.ts $S/examples/lantern-canyon/director.json --music $S/examples/lantern-canyon/music.wav \
--sfx $S/examples/lantern-canyon/sfx.wav --grade # -> examples/lantern-canyon/master.mp4
bun $S/scripts/check.ts $S/examples/lantern-canyon/director.json # measurements + contact sheet to look atFor your own game: copy examples/lantern-canyon/director.json next to the game's index.html, point
"url" at it, rewrite the shots. Local paths are served over http://127.0.0.1 for the run (ES
modules and CDN imports need http, not file://).
The workflow
1. Make the game capturable (5 minutes, once)
The recorder needs three things from the page. Add them to the game (or ask the agent that wrote it):
window.__game = {
ready: false, // set true after assets loaded AND the first frame rendered
renderer, camera, // the THREE.WebGLRenderer and the camera the game renders with
player, // optional Object3D the trailer camera can follow or look at
anchor, // optional Object3D: the player's position with the level's heading, no roll
setup(opts) { ... }, // reset to a known state: level, distance, score, autopilot, hud on/off
get events() { ... }, // optional: drain [{ type: 'pickup' | 'hit' | ... }] for sound effects
};Rules that make the capture exact (details: references/virtual-clock.md):
- All motion from
requestAnimationFrametime orperformance.now()deltas (the clock controls both). - The level layout uses its own seeded random stream, never
Math.randomand never the stream that cosmetic effects use (see gotchas). - HUD in HTML with
vhunits and ≥ 6vh side margins; no FPS counter or debug text unless?debug. - An attract-mode autopilot (the game plays itself) makes every non-hero shot easy to direct.
2. Shot list: 4-8 shots plus title and end card
Write it before any camera work. Roles drive the music and the checks:
| role | shows | camera that works | length |
establishing | the world, the mood, the player arriving | crane down from above, player rising into frame | 2.5-3.5 s |
mechanic | the core verb, with the HUD so people see it is a game | the game's own camera + scripted keys | 2.5-3 s |
mechanic (detail) | the hero object up close | low tracking shot in __game.anchor space | 1.5-2 s |
escalation | more speed, more enemies, more particles | game camera with boost, or a world-fixed fly-by | 1-2.5 s each |
hero | the one moment people screenshot | world-fixed camera, speed: 0.5 slow motion | 2.5-3 s |
title | the name over the game world | slow drift, HTML overlay, HUD hidden | 2-2.5 s |
end | where to play, what it is made of | card page | 1.5-2 s |
Cut on beats: give shots "beats" and the director a "bpm". At 100 BPM a beat is 0.6 s.
Order: wide → close → fast → faster → hero → title → end. Quick shots (1-1.5 s) belong in the
escalation; the hero shot gets room.
3. Director JSON
{ "url": "index.html", "fps": 30, "width": 1920, "height": 1080, "seed": 7, "bpm": 100,
"ready": "window.__game && window.__game.ready", "probe": "window.__game.state.score",
"shots": [
{ "id": "s2_mechanic", "role": "mechanic", "beats": 5,
"setup": "__game.setup({distance: 286, lat: 2.5, h: 2.0, score: 37})",
"inputs": [ { "at": 0.35, "key": "ArrowRight", "hold": 0.4 }, { "at": 1.1, "key": "ArrowLeft", "hold": 0.9 } ] },
{ "id": "s6_gate", "role": "hero", "beats": 5, "speed": 0.5,
"setup": "__game.setup({distance: 1226, autopilot: true, hud: false})",
"camera": { "space": "__game.place(1240)", "lookAt": "__game.player", "ease": "linear",
"keys": [ { "pos": [5, 0.5, -16], "fov": 52 }, { "pos": [3, 1.5, -19], "fov": 58 } ] } },
{ "id": "s8_end", "role": "end", "beats": 3, "card": "cards/card.html?title=MY%20GAME&sub=Play%20in%20your%20browser", "fade_out": 0.6 }
] }(Copy cards/ next to your game for the end card; the example points at ../../cards/card.html.)
Every shot is a fresh page load (deterministic start), then setup, then warmup seconds stepped
without recording, then the frames. Camera keys are positions in the space object's frame (three.js
convention: +x right, +y up, −z forward); the trailer camera replaces the game camera only inside
renderer.render and is restored after, so gameplay never sees it. All fields, inputs and overlays:
references/director-format.md.
4. Stills first, then verify
capture.ts … --stills writes the first, middle and last frame of every shot into capture/stills/ in
a few seconds (stepping costs 4-6 ms per frame without screenshots). Look at them with the Read tool
(montage them: magick montage *_b.jpg -tile 2x4 -geometry 960x540+4+4 sheet.jpg). Fix the camera,
the setup distance and the inputs here, where a try costs seconds. The probe value printed per shot
(the score, here) tells you whether scripted inputs actually did something.
Then capture.ts … --verify --only <shot> renders the first 45 frames twice from fresh loads and
compares PNG hashes. Measured: 45/45 identical with scripted keys and in slow motion. Anything less
means a clock, Math.random or load timing leaks into the picture.
5. Capture
capture.ts director.json writes capture/<shot>/00000.jpg … (JPEG q92; --format png for
lossless) and capture/manifest.json (frames, ms per frame, game events per frame, the visible text,
the probe). --only s2,s4 re-records some shots and keeps the rest.
6. Sound
- Free, in code:
score.ts director.jsonwritesmusic.wav(pad, bass, drums by role, a riser that lands on the hero shot's first game event, impacts on the gate and the title) andsfx.wav(a chime per pickup that climbs with the chain, a whoosh per gate, a thud per hit) placed on the exact frames the capture saw them. The Fable 5.2 games that spread generated all their sound in code too. - A real composition from varg: price it first, then generate an instrumental of the trailer's length:
estimate_cost({ tool: "music", input: { model: "mureka_9_5", prompt: "...", duration: 20 } }), show the price, and only after a yesgenerate_music({ model: "mureka_9_5", prompt: "dark cinematic trailer bed, 100 BPM, low drone, pulse, riser, one big hit at 0:11, instrumental, no vocals", duration: 20, instrumental: true }). Name the model: the tool's default is a much pricier one (varg-ailists mureka ~25 credits vs ~158). Thenbeats.ts music.mp3finds BPM and the first beat (measured: 99.79 BPM on a 100 BPM bed, first beat within 30 ms); put both in the director ("bpm","music": {"file", "offset"}) and re-time the shots in beats. Keepsfx.waveither way.
7. Cut
cut.ts director.json --music … --sfx … --grade builds the master: shots in order, fades
(fade_in, fade_out, flash_in), gentle contrast and vignette, the mix trimmed to the picture,
two-pass loudnorm to -14 LUFS / -1.5 dBTP, H.264 crf 18 + AAC 192k, +faststart. It also writes
master.cuts.json (where every shot sits). Text is never drawn by ffmpeg: titles are HTML in the
capture (this ffmpeg had no drawtext), so they get real fonts, tracking and CSS animation.
Preview for a gallery card (1280x720, 6-10 s, 0.4-2 MB):
ffmpeg -ss 11.4 -i master.mp4 -t 6.6 -vf scale=1280:-2:flags=lanczos -c:v libx264 -preset slow -crf 20 -pix_fmt yuv420p -an -movflags +faststart preview.mp4.
Measure the bitrate per shot first: dense particles cost 721 KB/s at these settings, an end card 86
KB/s, so a 2 MB preview cannot hold an 8 s ember storm.
8. Check, then look
check.ts director.json measures and prints: duplicate and frozen frames per shot (from the captured
frames, before grading), black frames outside fades, size/fps/codec, integrated loudness and true
peak, a contact sheet (every 15th frame, with a tile → time → shot legend), and every visible string
with flags for debug words, third-party names and claims. Then open the sheet and look at every tile:
the numbers do not see a camera inside a wall or a lantern that never enters the frame.
Before anyone sees it:
- no third-party IP: no franchise names in titles, captions, HUD, file names; no lookalike characters, logos or cars. "GTA-style" in a caption is still their name.
- captions are true: "one prompt" only if it was one prompt (keep the prompt); "real gameplay" only if the shot used the game camera; "made in 8 hours / for $550" only with the receipt. Scripted trailer cameras, slow motion and save states are normal in trailers; just do not caption them as "unedited".
- no real people's faces or voices; no brand logos on in-game objects.
Making the game in the first place (Claude Fable 5.2 / Claude Code)
The launch-day examples, all built by the model from a brief: @felixrieseberg's rainy-port FPS (2.3M views, about $550 of API, 8 hours, models, sounds and textures all from code), @kevin_t_ngo's lantern-boat ride through 8 dreamlike worlds (388k), @mattshumer_'s voxel engine with sound (222k), and @ericmaskfr's 80s-Miami open-world crime game (148k, 2 h 14 min). His brief is a model of a one-shot prompt: a role, a tight loop where every system feeds the next, a feel requirement, a no-assets rule, and a self-test loop with a stopping condition:
you're a senior game dev. build a third-person open-world crime game in a sunny 80s miami-style city. make the loop tight: walk, fight, steal a car, get chased, earn money, spend it. every system feeds the next: crimes bring heat, heat brings cops, missions pay, money unlocks the garage. cars need weight: gears, skids, real crashes. the city has to feel alive with traffic, people and day into night. no audio files, generate every sound in code. after each system, play it yourself, screenshot it and fix what looks wrong. don't stop until a stranger could play for 10 minutes without hitting a bug
(His post framed it as a clone of a famous franchise; the trailer must not.) Brief templates and the
trailer-hooks paragraph to append to any brief: references/game-brief.md.
Gotchas met building this skill
- A screen recording is not a trailer. Screenshotting the same game in real time advanced 84.5 ms of game time per captured frame (max 150 ms): played at 30 fps that is 2.5x too fast, with jumps. With the virtual clock every frame is exactly 33.3 ms and the screenshot shows the frame just stepped (tested with a frame-indexed colour: no lag).
- Shared random streams break scripted inputs. Adding decorative sky lanterns (220 → 260) consumed numbers from the world's random stream, every pickup moved, and the scripted keys scored 0 instead of 12. Give the level layout its own seeded stream.
- Plan inputs, do not guess them. Read the layout from the page (
__game.layout), then try timings: a grid of 486 key timings ran in 61 s (90 frames each, no screenshots) and found 12 points vs 2 with no input. Or use the game's autopilot for every shot that is not about the controls. - CSS class collisions. A title overlay class
.tlpicked up the game HUD's.tl {position: absolute; top-left}and the title's rule line flew to the corner. Prefix overlay classes. - Timers keep Bun alive.
Promise.race([..., Bun.sleep(60000)])left the recorder hanging 60 s after finishing; clear the timer. - Additive sprites near a camera become blobs. Mist sprites and close embers turned into big
teal and white balls in low trailer shots that the game camera never saw. Fade them by distance to
the render camera (
onBeforeRendergets the trailer camera). - The trailer camera finds geometry the game hides. A thin upward strip at the canyon rim (wall columns clamped to the rim height) showed as beige scratches only from trailer angles.
- Grain is expensive. Temporal film grain at crf 16 made an 18.6 s master 209 MB; without grain at crf 18 it is 19 MB with no visible banding (checked at 3x level stretch).
- AAC raises peaks. loudnorm at -1 dBTP on the WAV measured -0.7 dBFS after AAC; target -1.5.
- This ImageMagick has no fonts (no Freetype/Ghostscript):
montage -labelfails, so contact sheets come from ffmpegtilewith a printed legend instead of burned-in labels.
Files
| path | what |
scripts/virtual-clock.js | frame-exact clock: rAF, performance.now, Date, timers, CSS animations, seeded Math.random |
scripts/director-runtime.js | in-page half: trailer camera override, overlays, hidden selectors, letterbox, events |
scripts/cdp.ts | minimal Chrome DevTools Protocol client (launch, inject, keys, mouse, screenshot) |
scripts/capture.ts | director JSON → frames + manifest; --stills, --only, --verify, --gl swiftshader |
scripts/score.ts | music bed + game SFX written in code from the director and the capture events |
scripts/beats.ts | BPM + first beat of any track, for cutting on beats |
scripts/cut.ts | frames → master MP4: order, fades, grade, mix, two-pass loudnorm |
scripts/check.ts | duplicates, freezes, black frames, loudness, contact sheet, text/IP/claim audit |
cards/card.html | title and end card page (query parameters, CSS animation on the virtual clock) |
examples/lantern-canyon/ | the test game (one HTML file, three.js 0.181.2 from jsDelivr) and its director |
references/director-format.md | every director field, camera spaces, inputs, overlays, the manifest |
references/virtual-clock.md | what the clock covers and does not, load phases, determinism, Playwright variant |
references/game-brief.md | brief templates, the trailer-hooks contract, game-side lessons |
references/sound-and-cut.md | score arrangement, varg music, beats, loudness, grading, preview sizing |
| example trailer | the example's output (1920x1080, 18.6 s), hosted on s3.varg.ai; media is not kept in the repo |
Related skills
hyperframes (HTML → video, for trailers that are mostly motion graphics), threejs-animatic
(frame-by-frame three.js rendering for previz and Seedance video-to-video), varg-ai (music, voice,
AI footage, prices), short-form-ffmpeg-cookbook (vertical cut-downs, captions, reformatting the master
for TikTok/Reels/Shorts).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

