Does this skill help with GLSL to MSL shader conversion?

Yes, it provides a detailed mapping table for common GLSL types (like vec4) and functions (like mod) to their MSL equivalents (float4 and fmod).

How does the skill address Metal performance regressions?

It offers a decision tree to identify bottlenecks like GPU-CPU sync stalls and provides a standardized triple-buffering implementation pattern using semaphores.

How do I start debugging a Metal issue with this skill?

The skill mandates enabling Metal API and Shader Validation in your Xcode Scheme's Diagnostic settings as the first step to capture clear validation errors.

What common rendering issues can this skill diagnose?

It provides specific troubleshooting steps for black screens, upside-down images, mirrored textures, swapped colors (RBGA vs BGRA), and Z-fighting.

What Apple platforms are supported?

The diagnostics cover iOS 12+, macOS 10.14+, and tvOS 12+ development.

Axiom Metal Migration Diagnostics

Name: Axiom Metal Migration Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

Mobile Development

Provides systematic diagnosis and troubleshooting for porting graphics applications to Apple's Metal framework.

About

axiom-metal-migration-diag is a specialized diagnostic skill for Claude Code designed to help developers resolve complex issues encountered when migrating to or developing with the Metal graphics API. It provides structured decision trees for common failure modes like black screens, shader compilation errors, and performance regressions, offering actionable code fixes and configuration guidance for Xcode's Metal validation tools to reduce debugging time from hours to minutes.

Key Features

Interactive decision trees for troubleshooting black screens and rendering artifacts
Performance optimization patterns including triple buffering and resource storage modes
233 GitHub stars
GPU crash analysis for resource lifetime issues and command buffer timeouts
Comprehensive shader translation mapping from GLSL to Metal Shading Language (MSL)
Coordinate system and color space correction guidance for Metal's NDC and sRGB

Use Cases

Migrating legacy OpenGL or Vulkan codebases to Metal on iOS, macOS, and tvOS
Debugging GPU-specific crashes or execution aborted errors in Metal command buffers
Resolving visual discrepancies like flipped textures, color swaps, or Z-fighting

About

Key Features

Interactive decision trees for troubleshooting black screens and rendering artifacts
Performance optimization patterns including triple buffering and resource storage modes
233 GitHub stars
GPU crash analysis for resource lifetime issues and command buffer timeouts
Comprehensive shader translation mapping from GLSL to Metal Shading Language (MSL)
Coordinate system and color space correction guidance for Metal's NDC and sRGB

Use Cases

Migrating legacy OpenGL or Vulkan codebases to Metal on iOS, macOS, and tvOS
Debugging GPU-specific crashes or execution aborted errors in Metal command buffers
Resolving visual discrepancies like flipped textures, color swaps, or Z-fighting