About performance-at-scale
performance-at-scale is a skill for handling spatial indexing and world streaming in large-scale building systems. It provides selection guidance and scripts for spatial grids, octrees, chunk management, and profiling.
Key features
- 01SpatialHashGrid for uniform layouts
- 02Octree for clustered objects
- 03Chunk-based world streaming
- 04Performance profiling utilities
- 05Guidance on instancing, LOD, and memory
Use cases
- 01Querying nearby pieces in a uniform layout
- 02Handling clustered objects spatially
- 03Streaming chunks in large maps
- 04Benchmarking performance approaches
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/performance-at-scalein Claude Code to confirm it loaded.
Bundled files
References and scripts installed along with SKILL.md.
_meta.jsonreferences/performance-at-scale.mdscripts/chunk-manager.jsoctree.jsperformance-profiler.jsspatial-hash-grid.jsDetails
From the project READMEPerformance at Scale
Spatial indexing and world streaming for large-scale building systems.
Quick Start
import { SpatialHashGrid } from './scripts/spatial-hash-grid.js';
import { Octree } from './scripts/octree.js';
// Uniform distribution - use hash grid
const grid = new SpatialHashGrid(10);
grid.insert(piece, piece.position);
const nearby = grid.queryRadius(position, 15);
// Clustered bases - use octree
const octree = new Octree(bounds, { maxDepth: 8 });
octree.insert(piece);
const inBox = octree.queryBox(min, max);
Reference
See references/performance-at-scale.md for detailed guidance on:
- Spatial partitioning selection (when to use grid vs octree)
- Chunk loading strategies
- Instancing and LOD
- Memory management
Scripts
scripts/spatial-hash-grid.js- O(1) queries for uniform distributionscripts/octree.js- Adaptive queries for clustered objectsscripts/chunk-manager.js- World streaming for large mapsscripts/performance-profiler.js- Benchmarking utilities
Selection Guide
| Pieces | Distribution | Use |
|---|---|---|
| <1,000 | Any | Array |
| 1-5k | Uniform | SpatialHashGrid |
| 1-5k | Clustered | Octree |
| 5k+ | Any | ChunkManager + Octree per chunk |
Comments
Markdown supported