Graphics

You MUST use this skill for ANY GPU rendering, graphics programming, 3D content display, or display performance work.

When to Use

Use this router when:

• Porting OpenGL/OpenGL ES code to Metal
• Porting DirectX code to Metal
• Converting GLSL/HLSL shaders to Metal Shading Language
• Setting up MTKView or CAMetalLayer
• Rendering breaks or blurs when the window resizes or moves between screens
• Debugging GPU rendering issues (black screen, wrong colors, crashes)
• Evaluating translation layers (MetalANGLE, MoltenVK)
• Optimizing GPU performance or fixing thermal throttling
• App stuck at 60fps on ProMotion device
• Configuring CADisplayLink or render loops
• Variable refresh rate display issues
• Displaying 3D content in a non-game SwiftUI app
• Building AR experiences with RealityKit
• Using RealityView or Model3D in SwiftUI
• Spatial computing or visionOS 3D content
• Reading, editing, or exporting USD/USDZ files in Swift (USDKit)
• Adding ML to a render pipeline (MetalFX denoising, Metal tensors, neural rendering)
• Profiling long game sessions (metalperftrace, look-back traces)

Routing Logic

Metal Migration

Strategy decisions → See skills/metal-migration.md

• Translation layer vs native rewrite decision
• Project assessment and migration planning
• Anti-patterns and common mistakes
• Pressure scenarios for deadline resistance

API reference & conversion → See skills/metal-migration-ref.md

• GLSL → MSL shader conversion tables
• HLSL → MSL shader conversion tables
• GL/D3D API → Metal API equivalents
• MTKView setup, render pipelines, compute shaders
• Complete WWDC code examples

Diagnostics → See skills/metal-migration-diag.md

• Black screen after porting
• Shader compilation errors
• Wrong colors or coordinate systems
• Performance regressions
• Time-cost analysis per diagnostic path

Rendering Surfaces Under Window Resizing