metal-shader-expert

Q: How do I install metal-shader-expert?

Run npx skills add https://github.com/curiositech/some_claude_skills --skill metal-shader-expert in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/metal-shader-expert/ (personal) or .claude/skills/metal-shader-expert/ (project).

by curiositechCode Quality & Workflow

20 years Weta/Pixar experience in real-time graphics, Metal shaders, and visual effects. Expert in MSL shaders, PBR rendering, tile-based deferred rendering (TBDR), and GPU debugging. Activate on 'Metal shader', 'MSL', 'compute shader', 'vertex shader', 'fragment shader', 'PBR', 'ray tracing', 'tile shader', 'GPU profiling', 'Apple GPU'. NOT for WebGL/GLSL (different architecture), general OpenGL (deprecated on Apple), CUDA (NVIDIA only), or CPU-side rendering optimization.

Installs: 514
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/curiositech/some_claude_skills --skill metal-shader-expert

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads metal-shader-expert automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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

Topic	Novice	Expert
Data types	Uses `float` everywhere	Defaults to `half` (16-bit), `float` only when precision needed
Specialization	Runtime branching	Function constants for compile-time specialization
Memory	Everything in device space	Knows constant/device/threadgroup tradeoffs
Architecture	Treats like desktop GPU	Understands TBDR: tile memory is free, bandwidth is expensive
Ray tracing	Uses intersection queries	Uses intersector API (hardware-aligned)
Debugging	Print debugging	GPU capture, shader profiler, occupancy analysis

Common Anti-Patterns

32-Bit Everything

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

Ignoring TBDR Architecture

What it looks like	Why it's wrong
Treating Apple GPU like immediate-mode renderer	Tile 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 like	Why it's wrong
`if (material.useNormalMap)` checked every fragment	Creates divergent warps, wastes ALU
Instead: Function constants + pipeline specialization

Intersection Queries for Ray Tracing

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

Evolution Timeline

Era	Key Development
Pre-2020	Metal 2.x, OpenGL migration, basic compute
2020-2022	Apple Silicon, unified memory, tile shaders critical
2023-2024	Metal 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

Area	Skills
MSL	Kernel functions, vertex/fragment, tile shaders, ray tracing
Production	Asset pipelines, artist-friendly parameters, fast iteration
Rendering	PBR, IBL, volumetrics, post-processing, mesh shaders
Debug	Heat maps, shader inspection, GPU profiling, custom overlays

MCP Integrations

MCP	Purpose
Firecrawl	Research SIGGRAPH papers, Apple GPU architecture
WebFetch	Fetch Apple Metal documentation

Reference Files

File	Contents
`references/pbr-shaders.md`	Cook-Torrance BRDF, material structs, lighting calculations
`references/noise-effects.md`	Hash functions, FBM, Voronoi, domain warping, animated effects
`references/debug-tools.md`	Heat 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.

FAQ

What does the metal-shader-expert skill do?

How do I install metal-shader-expert?

Run npx skills add https://github.com/curiositech/some_claude_skills --skill metal-shader-expert in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/metal-shader-expert/ (personal) or .claude/skills/metal-shader-expert/ (project).

Which AI agents can use metal-shader-expert?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is metal-shader-expert safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains metal-shader-expert?

It is published by curiositech in curiositech/some_claude_skills. It has 514 recorded installs.