guidance-webgpu-performance

Installation
SKILL.md

Optimize WebGPU Performance

Find the limiting resource before changing the renderer. Produce a reproducible diagnosis that separates JavaScript preparation, browser/API submission, data transfer, and GPU execution, then make only changes supported by measurements.

Required context

  1. Read the repository AGENTS.md and the affected project's DEVELOPMENT.md.
  2. Inspect the render loop, update path, buffer and texture ownership, shader code, and resource lifecycle involved in the representative workload.
  3. Before adding or changing a benchmark, inspect the affected package's package.json, local Vitest benchmark configuration, existing *.test.bench.ts files, and any shared configuration they import. Do not assume another project's harness applies unchanged.
  4. Read the performance diagnostic playbook when classifying a bottleneck, selecting instrumentation, or proposing an optimization.
  5. Read the reusable WebGPU test suite guide when adding or reviewing a *.test.webgpu.ts suite, choosing a test mode, or deciding whether a performance task belongs in CI.

Establish the performance question

Define the workload and target before measuring:

Installs
5
Repository
nvidia/elements
GitHub Stars
113
First Seen
Oct 2, 2026