shadergraph-editor

The ShaderGraph Editor skill is a specialized toolkit for developers building high-fidelity spatial experiences for Apple Vision Pro using RealityKit. It provides an optimized workflow for creating and managing Shader Graph materials, bridging the gap between graphical authoring in Reality Composer Pro and programmatic control within Swift code. This skill is intended for technical artists, graphics engineers, and visionOS developers who need to implement custom shaders, handle MaterialX interop, or debug complex rendering pipelines in spatial applications.

• Streamlines the creation of Shader Graph materials by providing reference paths for node selection and graph optimization.

• Offers precise guidance on promoting graph inputs to facilitate runtime parameter adjustments using the RealityKit API.

• Includes diagnostic procedures for troubleshooting exported USD and MaterialX artifacts, helping to resolve rendering failures or unexpected visual output.

• Facilitates efficient hand-offs between graphical graph design and text-level USD structural edits, ensuring seamless integration with the broader visionOS development ecosystem.

• Supports the loading and lifecycle management of ShaderGraphMaterial instances within RealityKit, ensuring correct entity binding and material application.

• Always prefer Reality Composer Pro as the primary authoring surface, using this skill primarily for integration and debugging.

• Prioritize the use of provided documentation on runtime APIs when configuring inputs dynamically at execution time.

• Route complex stage hierarchy, prim path, or raw USD composition tasks to the usd-editor skill to maintain project integrity.

• Use this skill as a secondary reference when visual artifacts appear, checking for proper connection of promoted inputs and standard MaterialX export compliance.

• Expected inputs include ShaderGraph source files, material name references, and specific rendering problem descriptions, while expected outputs include configuration code snippets, debugging workflows, and structural validation steps for RealityKit projects.