prag-matt-ic/threenix-plugin

threenix-benchmark-webgpu

Measure Three.js WebGPU render or compute workloads with deterministic GPU timestamp fixtures.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/prag-matt-ic/threenix-plugin --skill threenix-benchmark-webgpu

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Benchmark Three.js WebGPU work

Measure a representative render or compute workload without changing production code. Read the benchmark guide for the runner command, fixture contract, and interpretation limits.

  1. Inspect the target project, its Three.js version, the real code path, and any existing fixture. Choose fixed inputs that represent the requested workload. The bundled runner needs a hardware WebGPU adapter with timestamp queries and a Node-compatible fixture; browser-only behavior needs a browser measurement instead.
  2. Build or adapt a fixture around the actual target code. Declare edited source dependencies and fixed workload inputs. Do not substitute the guide's synthetic example for a component measurement. If a faithful fixture cannot run, report the limitation without inventing timings.
  3. Run the bundled scripts/benchmark.mjs into a new output directory. Repeat the unchanged workload to establish timing noise. For an edit comparison, capture the baseline before the edit and use --baseline with the same fixture and settings afterward. Keep the original artifacts intact.
  4. Inspect GPU timing samples, workload and environment compatibility, shader snapshots, and output bytes. Investigate output differences. Repeat A/B runs under comparable conditions before claiming an improvement.
  5. Report the fixture, hardware, settings, artifact paths, medians and p05–p95 ranges, output comparison, and uncertainty. Pass timing does not identify the limiting shader stage or predict application FPS. A standalone baseline is a measurement, not a speedup claim.

Related by task

from this repository

More skills

All skills