Unity Shader

Skills Overview

Skills

shader_create

Create a shader file from template.

Templates:

shader_read

Read shader source code.

Returns: {success, path, content}

shader_list

List all shaders in project.

Returns: {success, count, shaders: [{name, path}]}

shader_find

Find a shader by name.

Returns: {success, name, path, propertyCount}

shader_delete

Delete a shader file.

shader_get_properties

Get all properties defined in a shader.

Returns: {success, properties: [{name, type, description}]}

shader_check_errors

Check shader for compilation errors.

Returns: { shaderName, hasErrors, messageCount }

shader_get_keywords

Get shader keyword list.

Returns: { shaderName, keywordCount, keywords: [{ name, type }] }

shader_get_variant_count

Get shader variant count for performance analysis.

Returns: { shaderName, subshaderCount, totalPasses }

shader_create_urp

Create a URP shader from template (type: Unlit or Lit).

Returns: { success, shaderName, path, type }

shader_set_global_keyword

Enable or disable a global shader keyword.

Returns: { success, keyword, enabled }

Example Usage

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']}")

Best Practices

1. Use consistent shader naming (Category/Name)
2. Organize shaders in dedicated folder
3. Start with templates, modify as needed
4. Test shaders in different lighting conditions
5. Consider mobile compatibility for builds

Canonical Signatures

以下附录以 SkillsForUnity/Editor/Skills/*Skills.cs 的真实 [UnitySkill] 签名为准，供审计和自动化解析使用。

shader_create

Create a new shader file

shader_read

Read shader source code

shader_list

List all shaders in project

shader_get_properties

Get properties of a shader

shader_find

Find shaders by name

shader_delete

Delete a shader file

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 (type: Unlit or Lit)

shader_set_global_keyword

Enable or disable a global shader keyword