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.

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

01Interactive decision trees for troubleshooting black screens and rendering artifacts

02Performance optimization patterns including triple buffering and resource storage modes

03233 GitHub stars

04GPU crash analysis for resource lifetime issues and command buffer timeouts

05Comprehensive shader translation mapping from GLSL to Metal Shading Language (MSL)

06Coordinate system and color space correction guidance for Metal's NDC and sRGB

Use Cases

01Migrating legacy OpenGL or Vulkan codebases to Metal on iOS, macOS, and tvOS

02Debugging GPU-specific crashes or execution aborted errors in Metal command buffers

03Resolving visual discrepancies like flipped textures, color swaps, or Z-fighting

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom axiom-metal-migration-diag

For use in Claude.ai and ChatGPT

Download Skill