unity-shader

Unity Shader Skills

Work with .shader HLSL/ShaderLab files (create from templates, read source, list, find, get keywords/properties/variants, check errors, delete, toggle global keywords). For node-based ShaderGraph use the shadergraph module.

Operating Mode

• Query skills (shader_read, shader_list, shader_find, shader_get_properties, shader_check_errors, shader_get_keywords, shader_get_variant_count) are SkillMode.SemiAuto — they run in all three modes without grant.
• Mutating skills (shader_create, shader_create_urp, shader_set_global_keyword) are SkillMode.FullAuto — under Approval they need user grant (grant triggers one server-side execute returning the result); under Auto / Bypass they execute directly.
• shader_delete carries SkillOperation.Delete and is auto-forbidden in Approval / Auto modes (NeverInSemi). Only Bypass or the user-managed Allowlist can run it.

Guardrails

DO NOT (common hallucinations):

• shader_set_property does not exist → use material_set_float/material_set_color/etc. on the material, not the shader
• shader_apply / shader_assign do not exist → use material_set_shader to change a material's shader
• shader_get_properties returns shader property definitions (name/type/range), not current values → for material instance values use material_get_properties
• Shader names are case-sensitive and path-like: "Standard", "Universal Render Pipeline/Lit", not "standard" or "URP Lit"

Routing:

• For material property changes → use material module
• For shader keyword control → material_set_keyword (material module)
• For global shader keywords → shader_set_global_keyword (this module)

Skills Overview

Skill	Description
shader_create	Create shader file
shader_read	Read shader source
shader_list	List all shaders
shader_find	Find shader by name
shader_delete	Delete shader file
shader_get_properties	Get shader properties
shader_check_errors	Check shader for compilation errors
shader_get_keywords	Get shader keyword list
shader_get_variant_count	Get shader variant count for performance analysis
shader_create_urp	Create a URP shader from template
shader_set_global_keyword	Enable or disable a global shader keyword