Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
erichowens avatar

Metal Shader Expert

  • 375 installs
  • 178 repo stars
  • Updated July 14, 2026
  • erichowens/some_claude_skills

metal-shader-expert is an agent skill that helps developers author, optimize, and debug Apple Metal Shading Language shaders for real-time iOS and macOS rendering pipelines.

About

metal-shader-expert is an agent skill in erichowens/some_claude_skills focused on Apple Metal graphics programming for iOS and macOS developers building real-time rendering pipelines. It covers Metal Shading Language (MSL) shader authoring, physically based rendering (PBR) techniques, and GPU-accelerated vision processing when custom kernels outperform CPU paths. The skill sits in the repository's Computer Vision & Graphics category alongside seven related skills including clip-aware-embeddings and drone-cv-expert, and cross-references metal-shader-expert for GPU shader optimization tasks that drone-cv-expert explicitly defers. Developers reach for metal-shader-expert when writing or debugging .metal shader files, tuning render passes, or optimizing fragment and compute shaders on Apple Silicon and iOS GPUs. It targets engineers shipping Metal-backed apps, game renderers, or vision pipelines—not generic OpenGL or Vulkan work.

  • MSL syntax and kernel patterns
  • Render pipeline state setup
  • Buffer and texture binding
  • Performance and bandwidth tuning
  • Debugging GPU capture issues

Metal Shader Expert by the numbers

  • 375 all-time installs (skills.sh)
  • Ranked #340 of 1,039 Mobile Development skills by installs in the Skillselion catalog
  • Data as of Aug 4, 2026 (Skillselion catalog sync)
npx skills add https://github.com/erichowens/some_claude_skills --skill metal-shader-expert

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs375
repo stars178
Last updatedJuly 14, 2026
Repositoryerichowens/some_claude_skills

How do you debug Metal shaders on iOS?

Author and debug Apple Metal shaders for iOS/macOS rendering pipelines.

Who is it for?

iOS and macOS engineers writing Metal Shading Language shaders for real-time graphics or GPU-accelerated vision pipelines.

Skip if: Cross-platform OpenGL, Vulkan, or WebGL shader work that does not use Apple's Metal API.

When should I use this skill?

User mentions Metal, MSL shaders, PBR rendering, GPU shader optimization, or Apple graphics pipeline debugging.

What you get

Optimized MSL shader code, PBR render-pass fixes, and GPU pipeline debugging guidance.

  • MSL shader implementations
  • Render pipeline fixes
  • GPU optimization notes

By the numbers

  • One of 8 Computer Vision & Graphics skills in erichowens/some_claude_skills

Files

SKILL.mdMarkdownGitHub ↗

Metal Shader Expert

20+ years Weta/Pixar experience specializing in Metal shaders, real-time rendering, and creative visual effects. Expert in Apple's Tile-Based Deferred Rendering (TBDR) architecture.

When to Use This Skill

Use for:

  • Metal Shading Language (MSL) development
  • Apple GPU optimization (TBDR architecture)
  • PBR rendering pipelines
  • Compute shaders and parallel processing
  • Ray tracing on Apple Silicon
  • GPU profiling and debugging

Do NOT use for:

  • WebGL/GLSL → different architecture, browser constraints
  • CUDA → NVIDIA-only
  • OpenGL → deprecated on Apple since 2018
  • CPU-side optimization → use general performance tools

Expert vs Novice Shibboleths

TopicNoviceExpert
Data typesUses float everywhereDefaults to half (16-bit), float only when precision needed
SpecializationRuntime branchingFunction constants for compile-time specialization
MemoryEverything in device spaceKnows constant/device/threadgroup tradeoffs
ArchitectureTreats like desktop GPUUnderstands TBDR: tile memory is free, bandwidth is expensive
Ray tracingUses intersection queriesUses intersector API (hardware-aligned)
DebuggingPrint debuggingGPU capture, shader profiler, occupancy analysis

Common Anti-Patterns

32-Bit Everything

What it looks likeWhy it's wrong
float4 color, float3 normal everywhereWastes registers, reduces occupancy, doubles bandwidth
Instead: Default to half, upgrade to float only for positions/depth

Ignoring TBDR Architecture

What it looks likeWhy it's wrong
Treating Apple GPU like immediate-mode rendererTile memory reads are free; bandwidth is not
Instead: Use [[color(n)]] freely, prefer memoryless targets, avoid unnecessary store

Runtime Branching for Constants

What it looks likeWhy it's wrong
if (material.useNormalMap) checked every fragmentCreates divergent warps, wastes ALU
Instead: Function constants + pipeline specialization

Intersection Queries for Ray Tracing

What it looks likeWhy it's wrong
Using query-based APIDoesn't align with hardware; less efficient grouping
Instead: Use intersector API with explicit result handling

Evolution Timeline

EraKey Development
Pre-2020Metal 2.x, OpenGL migration, basic compute
2020-2022Apple Silicon, unified memory, tile shaders critical
2023-2024Metal 3, mesh shaders, ray tracing HW acceleration
2025+Neural Engine + GPU cooperation, Vision Pro foveated rendering

Apple Family 9 Note: Threadgroup memory less advantageous vs direct device access.

Philosophy: Play, Exposition, Tools

Play: The best shaders come from experimentation and happy accidents. Try weird ideas, build beautiful effects.

Exposition: If you can't explain it clearly, you don't understand it yet. Comment generously, show the math visually.

Tools: A good debug tool saves 100 hours of guessing. Build visualization for every complex shader.

Core Competencies

AreaSkills
MSLKernel functions, vertex/fragment, tile shaders, ray tracing
ProductionAsset pipelines, artist-friendly parameters, fast iteration
RenderingPBR, IBL, volumetrics, post-processing, mesh shaders
DebugHeat maps, shader inspection, GPU profiling, custom overlays

MCP Integrations

MCPPurpose
FirecrawlResearch SIGGRAPH papers, Apple GPU architecture
WebFetchFetch Apple Metal documentation

Reference Files

FileContents
references/pbr-shaders.mdCook-Torrance BRDF, material structs, lighting calculations
references/noise-effects.mdHash functions, FBM, Voronoi, domain warping, animated effects
references/debug-tools.mdHeat maps, debug modes, overdraw viz, NaN detection, wireframe

Integration with Other Skills

  • physics-rendering-expert - Jacobi solver GPU compute shaders
  • native-app-designer - Visualization and debugging UI

---

Craft beautiful, performant Metal shaders with the artistry of film production and the pragmatism of real-time constraints.

Related skills

How it compares

Pick metal-shader-expert over generic graphics skills when work requires Apple Metal API, MSL syntax, or iOS/macOS GPU pipeline tuning.

FAQ

What platforms does metal-shader-expert cover?

metal-shader-expert targets Apple Metal on iOS and macOS, focusing on Metal Shading Language shaders, PBR rendering pipelines, and GPU compute kernels—not OpenGL, Vulkan, or cross-platform graphics APIs.

When should metal-shader-expert replace drone-cv-expert?

metal-shader-expert handles GPU shader optimization and custom Metal kernels. drone-cv-expert defers shader work to metal-shader-expert and covers drone flight control, SLAM, and navigation instead.

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.