specs-optimize-lens-mesh

Merge RenderMeshVisuals that share the same material into single GLB meshes using MergeMeshesTool, then decimate the results with SimplifyMeshTool. The Skill analyzes the prefab, groups mergeable meshes by material, and mutates the prefab to reference the consolidated meshes.

Inspect each ScriptComponent for SceneObject or SceneObject[] inputs such as toggle lists, highlight lists, and transform targets, and mark those UUIDs as protected. Only non-protected RenderMeshVisuals are merged, and protected SceneObjects are never deleted or reparented.

The workflow requires the Lens Studio MCP tools scene-graphql, asset-graphql, ExecuteEditorCode, MergeMeshesTool, and SimplifyMeshTool. These handle prefab enumeration, mesh merging, decimation previews, and prefab mutation through the Editor API.

Skip meshes under roughly 500 triangles, thin flat geometry like rotor blades or decals, highlight components users inspect directly, and meshes packed inside an FBX with no standalone file. Heavy FBX-packed meshes should be routed through the merge step first to produce a standalone GLB.

MergeMeshesTool bakes world transforms into vertex positions, so the new merged SceneObject must be parented under a node with the same effective world transform as the sources. Placing it at the wrong hierarchy level offsets the merged geometry.