majiayu000/claude-arsenal
xiaohongshu
xiaohongshu
286 148
View 
Metal Shader Expert
metal-shader-expert
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', 't...
SKILL.md
Full skill instructions
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.
More skills from majiayu000
majiayu000/claude-arsenal
technical-spec
technical spec
286 141
View majiayu000/claude-arsenal
product-ux-expert
product ux expert
286 133
View majiayu000/claude-arsenal
database-patterns
database patterns
286 119
View majiayu000/claude-skill-registry
agent-task-conductor
Conduct multi-agent task orchestration and workflow coordination.
663 1
View majiayu000/claude-skill-registry
conductor-setup
Initialize project with Conductor artifacts (product definition,
663 1
View majiayu000/claude-skill-registry
animation-designer
Expert in web animations, transitions, and motion design using Framer Motion and CSS
663 1
View majiayu000/claude-skill-registry
diagramming
Creates Mermaid and ASCII diagrams for flowcharts, architecture, ERDs, state machines, mindmaps, and more. Use when user mentions diagram, flowchart, mermaid, ASCII diagram, text diagram, terminal diagram, visualize, C4, mindmap, architecture diagram, sequence diagram, ERD, or needs visual docume...
663 1
View majiayu000/claude-skill-registry-data
h3-pg
PostgreSQL bindings for H3 hexagonal grid system. Use when working with H3 cells in Postgres, including spatial indexing, geometry/geography integration, and raster analysis.
23 1
View majiayu000/claude-skill-registry
conductor-development
Context-Driven Development skill for projects using Conductor. Use this skill when you detect a `conductor/` directory in the project, when working on tasks defined in a `plan.md` file, or when the user asks about tracks, specs, or plans. Automatically applies TDD workflow, tracks task completion...
663 1
View majiayu000/claude-skill-registry
conductor-status
Display project status, active tracks, and next actions
663 1
View majiayu000/claude-skill-registry
dockerization
Official Stakpak application containerization standard operating procedure, a step-by-step guidline to properly dockerize applications. This is a rule book curated by the Stakpak Team.
663 1
View Popular AI tools
Video
Kaiber
Generate, edit, and beat-sync AI video with leading models in one workspace.
Paid
View Productivity
Vimcal
The world's fastest calendar for remote work
Free
View Images
IMGCreator.ai
Transform Your Design with AI Designer by ImgCreator.ai
Freemium
View Content & writing
Akool AI
Revolutionizing Video Production with AI-Powered Creativity
Paid
View Images
Clipdrop Uncrop
Extend an image past the frame and let AI fill the new aspect ratio.
Freemium
View Security
StarByFace
Discover your celebrity doppelgänger with StarByFace!
Free
View C
Finance
ChainClarity
ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.
Freemium
View Coding & apps
Opus Clip
Opus.ai: Revolutionize Your Web Experience
Free
View