← ClaudeAtlas

three-perflisted

Measure and speed up a three.js or React Three Fiber scene without lowering picture quality. Use when a WebGL/three.js/R3F page drops frames, stutters, freezes on first view (especially in Safari), loads slowly, or shows a loading count that stalls; when asked to profile, benchmark or optimise draw calls, shaders, post-processing or the warm-up; or to prove an optimisation changed nothing visible.
skyeyesec333/three-perf · ★ 0 · Web & Frontend · score 72
Install: claude install-skill skyeyesec333/three-perf
# three-perf: faster frames, same picture ``` 1. hook install the page hook (dev only): named camera views + a full-frame render() 2. measure frametime.mjs (GPU-synced ms per view) warmup.mjs (ready time, late shaders; --cold for a first visit) 3. change ONE thing, behind a ?off=name switch 4. measure the same views, the same conditions 5. compare compare.mjs before vs after: side by side, 1:1 crops, pixel diff; look at them 6. report numbers with conditions; what changed on screen (should be nothing) ``` **The rule that outranks the rest:** never trade visible quality for speed without the owner's explicit yes. No automatic resolution scaling, no lower pixel ratio, no fewer particles, no blurrier shadows, unless they agreed to that specific trade after seeing it. Make the frame cheaper instead. Scripts are in this skill's own folder: set `S="${CLAUDE_SKILL_DIR}/scripts"` once per shell (the same for a plugin install and a copied one). Page modules are in `${CLAUDE_SKILL_DIR}/src`: copy the ones you need into the app. They need Node 18+ and Playwright (`npm i -D playwright-core` in the project, or `PLAYWRIGHT=<path to its index.mjs>`; the path actually loaded is printed). Chromium runs uncapped; `--engine webkit` uses Playwright's WebKit (`npx playwright install webkit`), which is close to Safari but not Safari: confirm findings in real Safari. Any http(s) address works, not only localhost; the page is loaded like any visit. A `PLAYWRIGHT=` path that fa