Agent Skills: RealityKit Rendering Materials

RealityKit Rendering Materials

Quick Start

1. Confirm the issue is visual: mesh display, material assignment, camera projection, lighting, shadows, post-processing, splats, decals, LOD, occlusion, or probes.
2. Load the narrowest rendering reference that matches the feature.
3. Route ShaderGraph or USDA material graph editing to shadergraph-editor.
4. Route local USD stage rendering through realitykit-visionos-developer; route USD authoring to usd-editor.
5. Validate on device or simulator with concrete visual checks, because many rendering issues are asset-, lighting-, or hardware-dependent.

Load References When

| Reference | When to Use | |---|---| | references/modelcomponent.md | Render meshes and assign RealityKit materials. | | references/modeldebugoptionscomponent.md | Inspect or debug model rendering output. | | references/meshinstancescomponent.md | Reuse mesh instances efficiently. | | references/modelsortgroupcomponent.md | Control model sorting for transparent or layered content. | | references/opacitycomponent.md | Control entity opacity. | | references/adaptiveresolutioncomponent.md | Manage adaptive resolution. | | references/levelofdetailcomponent.md | Select content by distance or detail tier. | | references/occlusioncullingcomponent.md | Reduce render work for hidden content. | | references/gaussiansplatcomponent.md | Render Gaussian splat captures. | | references/physicallybaseddecalcomponent.md | Project physically based decals onto geometry. | | references/clippingcomponent.md | Clip rendered geometry against bounds. | | references/tonemappingcomponent.md and references/bloomcomponent.md | Tune tone mapping and bloom post-processing. | | references/pointlightcomponent.md, references/directionallightcomponent.md, references/spotlightcomponent.md | Add or debug direct lights. | | references/imagebasedlightcomponent.md and references/imagebasedlightreceivercomponent.md | Configure image-based lighting and receivers. | | references/groundingshadowcomponent.md, references/dynamiclightshadowcomponent.md, references/render-layers-and-shadows.md | Tune grounding shadows, dynamic shadows, render layers, and per-light masks. | | references/environmentlightingconfigurationcomponent.md, references/virtualenvironmentprobecomponent.md, references/lightmaps-and-probes.md | Configure environment lighting, virtual probes, baked lightmaps, and diffuse probes. | | references/perspectivecameracomponent.md, references/orthographiccameracomponent.md, references/projectivetransformcameracomponent.md | Work with RealityKit cameras and projection. |

Cross-Routing

• Use realitykit-visionos-developer for entity loading, input, attachments, anchoring, portals, synchronization, and local USDStageComponent.
• Use realitykit-animation-physics when the visual issue is caused by animation, blendshape, particle, cloth, collision, or physics state.
• Use realitykit-ecs-systems when rendering state is driven by a custom component or per-frame system.
• Use shadergraph-editor for material graph source edits.

Guardrails

• Treat visionOS 27 rendering additions as beta API; re-verify symbols against the installed SDK before shipping.
• Keep expensive material, mesh, and texture loading asynchronous.
• Validate visual changes with screenshots or simulator/device inspection when possible.
• Prefer documented RealityKit components before custom draw or update logic.

Output Expectations

Provide:

• the rendering category
• which rendering reference files were used
• the chosen component or asset path
• the visual/performance constraint
• the next screenshot, simulator, or device validation step