Shader creation and management. Use when users want to create or inspect shaders. Triggers: shader, HLSL, ShaderLab, Unlit, Standard, custom shader, 着色器, 创建Shader.
Work with shaders - create shader files, read source code, and list available shaders.
Mode: Full-Auto required
DO NOT (common hallucinations):
shader_set_property does not exist → use material_set_float/material_set_color/etc. on the material, not the shadershader_apply / shader_assign do not exist → use material_set_shader to change a material's shadershader_get_properties does not exist → use material_get_properties on a material using the shader"Standard", "Universal Render Pipeline/Lit", not "standard" or "URP Lit"Routing:
material modulematerial_set_keyword (material module)shader_set_global_keyword (this module)| 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 |
Create a shader file from template.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderName | string | Yes | - | Shader name (e.g., "Custom/MyShader") |
savePath | string | Yes | - | Save path |
template | string | No | "Unlit" | Template type |
Templates:
| Template | Description |
|---|---|
Unlit | Basic unlit shader |
Standard | PBR surface shader |
Transparent | Alpha blended |
Read shader source code.
| Parameter | Type | Required | Description |
|---|---|---|---|
shaderPath | string | Yes | Shader asset path |
Returns: {success, path, content}
List all shaders in project.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | null | Name filter |
limit | int | No | 100 | Max results |
Returns: {success, count, shaders: [{name, path}]}
Find a shader by name.
| Parameter | Type | Required | Description |
|---|---|---|---|
shaderName | string | Yes | Shader name to find |
Returns: {success, name, path, propertyCount}
Delete a shader file.
| Parameter | Type | Required | Description |
|---|---|---|---|
shaderPath | string | Yes | Shader asset path |
Get all properties defined in a shader.
| Parameter | Type | Required | Description |
|---|---|---|---|
shaderName | string | No* | Shader name |
shaderPath | string | No* | Shader asset path |
Returns: {success, properties: [{name, type, description}]}
shader_check_errorsCheck shader for compilation errors.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader") |
Returns: { shaderName, hasErrors, messageCount }
shader_get_keywordsGet shader keyword list.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader") |
Returns: { shaderName, keywordCount, keywords: [{ name, type }] }
shader_get_variant_countGet shader variant count for performance analysis.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader") |
Returns: { shaderName, subshaderCount, totalPasses }
shader_create_urpCreate a URP shader from template (type: Unlit or Lit).
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderName | string | Yes | - | Shader name (e.g., "Custom/MyURPShader") |
savePath | string | Yes | - | Save path (e.g., "Assets/Shaders/MyURP.shader") |
type | string | No | "Unlit" | Template type: "Unlit" or "Lit" |
Returns: { success, shaderName, path, type }
shader_set_global_keywordEnable or disable a global shader keyword.
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
keyword | string | Yes | - | Global shader keyword name |
enabled | bool | Yes | - | true to enable, false to disable |
Returns: { success, keyword, enabled }
import unity_skills
# Create an unlit shader
unity_skills.call_skill("shader_create",
shaderName="Custom/MyUnlit",
savePath="Assets/Shaders/MyUnlit.shader",
template="Unlit"
)
# Create a surface shader
unity_skills.call_skill("shader_create",
shaderName="Custom/MyPBR",
savePath="Assets/Shaders/MyPBR.shader",
template="Standard"
)
# Read shader source
source = unity_skills.call_skill("shader_read",
shaderPath="Assets/Shaders/MyUnlit.shader"
)
print(source['content'])
# List all custom shaders
shaders = unity_skills.call_skill("shader_list", filter="Custom")
for shader in shaders['shaders']:
print(f"{shader['name']}: {shader['path']}")
以下附录以 SkillsForUnity/Editor/Skills/*Skills.cs 的真实 [UnitySkill] 签名为准，供审计和自动化解析使用。
Create a new shader file
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderName | string | Yes | - | Canonical signature parameter |
savePath | string | Yes | - | Canonical signature parameter |
template | string | No | null | Canonical signature parameter |
Read shader source code
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderPath | string | Yes | - | Canonical signature parameter |
List all shaders in project
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
filter | string | No | null | Canonical signature parameter |
limit | int | No | 100 | Canonical signature parameter |
Get properties of a shader
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Canonical signature parameter |
Find shaders by name
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
searchName | string | Yes | - | Canonical signature parameter |
Delete a shader file
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderPath | string | Yes | - | Canonical signature parameter |
Check shader for compilation errors
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Canonical signature parameter |
Get shader keyword list
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Canonical signature parameter |
Get shader variant count for performance analysis
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderNameOrPath | string | Yes | - | Canonical signature parameter |
Create a URP shader from template (type: Unlit or Lit)
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
shaderName | string | Yes | - | Canonical signature parameter |
savePath | string | Yes | - | Canonical signature parameter |
type | string | No | "Unlit" | Canonical signature parameter |
Enable or disable a global shader keyword
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
keyword | string | Yes | - | Canonical signature parameter |
enabled | bool | Yes | - | Canonical signature parameter |