unity-shader

Create, inspect, and manage HLSL/ShaderLab .shader files in Unity projects.

Updated Aug 31, 2026
One-click install
npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-shader-pikachu0310
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-shader
Source: https://github.com/pikachu0310/codex-agent-ops-public/tree/main/.agents/skills/unity-skills/skills/shader
Command: npx skills add https://github.com/pikachu0310/codex-agent-ops-public --skill unity-shader-pikachu0310

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with handwritten Unity shaders requires repetitive file operations and careful inspection of properties, keywords, and compilation errors, which is slow and error-prone when done manually across a large project. ## Core Features & Use Cases - Shader Creation: Generate .shader files from raw ShaderLab/HLSL source or from built-in URP Unlit/Lit templates via shader_create and shader_create_urp. - Inspection & Search: Read shader source, list and find shaders by name, and retrieve property definitions, keyword lists, and variant counts for performance analysis. - Diagnostics & Control: Check shaders for compilation errors and toggle global shader keywords, with guardrails routing material-level changes to the material module. - Use Case: While optimizing a URP project, list all custom shaders, check each for compile errors, and compare variant counts to find shaders bloating build size. ## Quick Start Ask the agent to create a URP Lit shader named Custom/MyShader at Assets/Shaders/MyShader.shader and then check it for compilation errors.

Frequently Asked Questions about unity-shader

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a URP shader in Unity from a template?

Use shader_create_urp with a shader name, save path, and type set to Unlit or Lit. It generates a ready-to-use URP shader file, unlike shader_create where the template parameter is raw source code written verbatim.

How do I check a Unity shader for compilation errors?

Call shader_check_errors with the shader name or asset path, such as Custom/MyShader or Assets/Shaders/My.shader. It returns the shader name, a hasErrors flag, and the number of diagnostic messages.

What is the difference between shader properties and material properties in Unity?

shader_get_properties returns the property definitions declared in the shader, including name, type, and range. To read or change actual values on a material instance, use the material module functions such as material_get_properties or material_set_float.

Can I delete a shader file automatically in Unity?

shader_delete removes a shader asset but is auto-forbidden in Approval and Auto modes. It only runs under Bypass mode or when explicitly added to the user-managed allowlist, preventing accidental deletion.

Why does my shader name lookup fail in Unity?

Shader names are case-sensitive and path-like, such as "Universal Render Pipeline/Lit", not "URP Lit" or "standard". Use shader_find or shader_list to discover the exact declared name before referencing it.