Skip to main content
skill CX Codex

threejs-performance · cesartevisual — Claude Code skill: what it does, how to install

threejs-performance is a Claude Code skill that profiles and optimizes Three.js frame time, GPU workload, asset memory, and resource leaks.

MIT 817 installs ★ 26 updated 2026-09-10

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add cesartevisual/threejs-skills --skill threejs-performance -a claude-code
Open on GitHub

What threejs-performance does

The assistant evaluates CPU work, draw calls, shader complexity, and memory usage against the project's architecture. It measures frame-time distribution, viewport parameters, and pixel ratios to distinguish initial compile stalls from runtime frame costs. Resource cleanup covers geometries, materials, textures, and mixers, noting that disposing a renderer or material does not automatically free all linked scene objects.

Isolating variables helps determine whether a bottleneck stems from pixel fill rates or vertex counts. Mount and unmount cycles are measured to detect rising memory trends over time. Official documentation or installed type definitions are referenced for revision-specific behavior.

Profiling records before and after metrics using the worksheet in references/profile.md.

What it helps with

  • profile Three.js frame time and GPU load
  • detect memory leaks in textures and geometries
  • reduce excessive draw calls and overdraw
  • optimize asset memory in 3D scenes

Example prompts for the agent

  • Profile Three.js frame time with threejs-performance
  • Find memory leaks in scene materials
  • Optimize GPU workload and draw calls

How to install threejs-performance

1Skills CLI (Vercel)

npx skills add cesartevisual/threejs-skills --skill threejs-performance -a claude-code

2Manually: put the files in place

~/.claude/skills/threejs-performance/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/threejs-performance/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about threejs-performance

How to install threejs-performance in Claude Code?

Run npx skills add cesartevisual/threejs-skills --skill threejs-performance -a claude-code, then check ~/.claude/skills/threejs-performance/SKILL.md.

What does threejs-performance do?

It profiles and optimizes Three.js applications by measuring frame rates, GPU workload, memory usage, and resource leaks.

Where is the profiling worksheet located?

The before and after record is detailed in references/profile.md.

Source text

SKILL.md · MIT
---
name: threejs-performance
description: "Profile and optimize Three.js frame time, GPU workload, asset memory, and resource leaks."
---

# Performance and Memory

Use the project's installed versions and existing architecture. These instructions supplement the user's task; they do not authorize unrelated changes or external actions.

Reproduce on a representative device and record scene state, viewport, pixel ratio, backend, asset sizes, and frame-time distribution. Distinguish first-load/decode/compile stalls from steady-state frame cost. Read [the profiling worksheet](references/profile.md) for a repeatable before/after record.

Determine whether the bottleneck is CPU work, submission/draw calls, GPU shading/fill, transfers, or memory. Reduce resolution to probe pixel cost; isolate shadows/effects; compare static versus animated updates. Change one major variable at a time.

Use instancing/batching when draw calls dominate, reduce overdraw/effect resolution when fill dominates, and simplify animation or move appropriate work off-thread when CPU-bound. Lowering triangles will not fix every bottleneck. Avoid per-frame allocations and repeated shader recompilation.

Define resource ownership across shared caches and instances. Release owned geometries, materials, textures, targets, controls, mixers, observers, and listeners. Disposing a material does not dispose its textures; disposing a renderer does not free all scene-owned objects. Do not dispose cache entries still in use.

Measure repeated mount/unmount and model replacement after warmup. Internal caches can leave nonzero counters; look for an unexplained rising trend rather than demanding zero. CPU heap and renderer.info are partial evidence, not exact GPU memory.

Accept an optimization only when the measured improvement preserves required appearance and interaction. Report device, method, before/after values, and limits of the measurements.

## API reference

Consult the [official documentation](https://threejs.org/docs/pages/WebGLRenderer.html) for exact signatures and revision-specific behavior. If documentation access is unavailable, inspect installed types/source and state any remaining uncertainty.

© cesartevisual · MIT · cesartevisual/threejs-skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

threejs-performance by other authors comes first.

threejs-performance CloudAI-X threejs-performance — a skill for Claude Code, Codex, Cursor and other platforms measures three.js rendering speed and optimizes scenes. Runs when a scene lags or hits memory limits. CX Codex +1 7,100installs optimize-threejs-games MengTo optimize-threejs-games — a skill that profiles and speeds up Three.js and WebGL games: it finds whether the CPU or the GPU is the bottleneck, then fixes it without breaking gameplay. CX Codex +1 1,700installs threejs-perf OpusGameLabs threejs-perf converts repeated Three.js meshes to InstancedMesh instances and batches matrix updates. Cuts draw calls in scenes with hundreds of shared geometries. CX Codex +1 753installs threejs-aaa-graphics-builder majidmanzarpour threejs-aaa-graphics-builder — a skill for upgrading Three.js games from rough prototypes to production visuals: builds materials, lighting, VFX, shaders, and evaluates scenes against a scorecard. CX Codex +1 4,300installs threejs-debug-profiler majidmanzarpour threejs-debug-profiler tracks down blank canvases and runtime render bugs in Three.js browser games. Measures draw calls, shaders, and memory bottlenecks without breaking playability. CX Codex +1 4,000installs improve-threejs millionco improve-threejs is a Claude Code skill that audits Three.js and React Three Fiber code for frame-rate drops and GPU leaks. Runs when requesting 3D audits or typing /improve-threejs. CX Codex +1 451installs threejs-game OpusGameLabs The threejs-game skill for Claude Code sets a project structure and required modules for Three.js browser games. It scaffolds a scene and game loop from scratch. CX Codex +1 1,200installs

From the same set24

The whole set →
threejs-r3f The threejs-r3f Claude Code skill helps build and repair React Three Fiber scenes. It covers Drei helpers, Suspense loading, events, and React lifecycle integration. CX Codex +1 820installs threejs-web This Claude Code skill plans and builds Three.js web experiences or focused 3D features. It inspects the project and checks the result in a browser. CX Codex +1 776installs threejs-animation threejs-animation — a skill for Claude Code guides animation work in Three.js. It covers clips, skeletal motion, transitions, and scroll-driven timelines. CX Codex +1 753installs threejs-lighting The threejs-lighting Claude Code skill guides lighting and shadow work in Three.js scenes. It comes into play when setting up environment maps, direct lights, or shadow maps. CX Codex +1 694installs threejs-shaders threejs-shaders — a Claude Code skill for writing and debugging Three.js GLSL shaders, custom material effects, uniforms, and geometry deformation. CX Codex +1 694installs threejs-testing threejs-testing — a skill for Claude Code defines visual QA and browser testing guidelines for Three.js scenes. Focuses on deterministic fixtures, GPU checks, and teardown lifecycle tests. CX Codex +1 681installs threejs-interaction This Claude Code skill guides Three.js interaction work, from object picking to orbit controls. It applies when an agent is asked to add dragging, selection, or synchronized HTML controls. CX Codex +1 681installs threejs-assets The threejs-assets Claude Code skill guides loading and managing glTF models, textures, and user-provided 3D files. It applies to asset validation, compression, caching, and cleanup in Three.js projects. CX Codex +1 676installs

Project sponsors

Companies that keep this analytics open