Agent skill

Unity Shader

by Besty0728 in Besty0728/Unity-Skills

“Manage HLSL/ShaderLab .shader files”

— description from SKILL.md by Besty0728
MITAuto-check passedGame Development

Install Unity Shader

skills CLI
$ npx skills add Besty0728/Unity-Skills --skill unity-shader -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Besty0728/Unity-Skills unity-shader --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Besty0728/Unity-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/'SkillsForUnity/unity-skills~/skills/shader' .claude/skills/unity-shader && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
unity-shader
GitHub stars
1.8k
Token cost
~2.1k tokens
SKILL.md length
754 words
Files
1
Skills in repo
82
Repo updated
First seen
Licence
MIT

At a glance

  • Works in 5 steps: Use consistent shader naming… → Organize shaders in dedicated folder → Start with templates, modify as needed → …
  • SKILL.md covers Triggers, Operating Mode, Guardrails and Skills Overview, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

About this skill

Unity Shader is a skill in Besty0728/Unity-Skills (1.8k stars). Its SKILL.md is about 2.1k tokens. Licence: MIT.

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  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

What it can do on your machine

Read from SKILL.md and the folder at commit 12a40e4. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are python).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Unity Shader loads about 2.1k tokens when it runs. Until then it costs about 12 tokens; SKILL.md has 754 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~12
When it runs · the whole SKILL.md, loaded when a task matches
~2.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Besty0728/Unity-Skills at commit 12a40e4, republished under its MIT licence (© Besty0728). 754 words, ~2,069 tokens.

Download SKILL.mdSave it as .claude/skills/unity-shader/SKILL.md (or your agent's skills folder).
name
unity-shader
description
Manage HLSL/ShaderLab .shader files

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

  • Creating or editing handwritten shaders
  • Listing or finding .shader files
  • Inspecting properties/keywords
  • 创建或编辑手写 shader、列出/查找 .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

SkillDescription
shader_createCreate shader file
shader_readRead shader source
shader_listList all shaders
shader_findFind shader by name
shader_deleteDelete shader file
shader_get_propertiesGet shader properties
shader_check_errorsCheck shader for compilation errors
shader_get_keywordsGet shader keyword list
shader_get_variant_countGet shader variant count for performance analysis
shader_create_urpCreate a URP shader from template
shader_set_global_keywordEnable or disable a global shader keyword

Skills

shader_create

Create a shader file. The template parameter is raw shader source code that gets written verbatim into the .shader file — it is not a preset name. If you pass template="Standard" the literal string Standard will be written to disk and the shader will fail to compile.

ParameterTypeRequiredDefaultDescription
shaderNamestringYes-Shader name written into the Shader "..." declaration (e.g., "Custom/MyShader")
savePathstringYes-Save path (e.g., "Assets/Shaders/My.shader")
templatestringNonullFull ShaderLab/HLSL source string. When omitted, a built-in Unlit template (_MainTex + _Color, single CGPROGRAM pass) is used. There are no other built-in presets.

For a URP Unlit / Lit preset, use shader_create_urp (type: "Unlit" | "Lit") instead — it actually selects a template by name.

shader_read

Read shader source code.

ParameterTypeRequiredDescription
shaderPathstringYesShader asset path

Returns: {path, lines, content}

Show full SKILL.md (308 more words)Show less
shader_list

List all shaders in project.

ParameterTypeRequiredDefaultDescription
filterstringNonullName filter
limitintNo100Max results

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

shader_find

Find a shader by name.

ParameterTypeRequiredDescription
searchNamestringYesShader name to find

Returns: {found, name, path}

shader_delete

Delete a shader file.

ParameterTypeRequiredDescription
shaderPathstringYesShader asset path
shader_get_properties

Get all properties defined in a shader.

ParameterTypeRequiredDescription
shaderNameOrPathstringYesShader name or shader asset path

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

shader_check_errors

Check shader for compilation errors.

ParameterTypeRequiredDefaultDescription
shaderNameOrPathstringYes-Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader")

Returns: { shaderName, hasErrors, messageCount }

shader_get_keywords

Get shader keyword list.

ParameterTypeRequiredDefaultDescription
shaderNameOrPathstringYes-Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader")

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

shader_get_variant_count

Get shader variant count for performance analysis.

ParameterTypeRequiredDefaultDescription
shaderNameOrPathstringYes-Shader name or asset path (e.g., "Custom/MyShader" or "Assets/Shaders/My.shader")

Returns: { shaderName, subshaderCount, totalPasses }

shader_create_urp

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

ParameterTypeRequiredDefaultDescription
shaderNamestringYes-Shader name (e.g., "Custom/MyURPShader")
savePathstringYes-Save path (e.g., "Assets/Shaders/MyURP.shader")
typestringNo"Unlit"Template type: "Unlit" or "Lit"

Returns: { success, shaderName, path, type }

shader_set_global_keyword

Enable or disable a global shader keyword.

ParameterTypeRequiredDefaultDescription
keywordstringYes-Global shader keyword name
enabledboolYes-true to enable, false to disable

Returns: { success, keyword, enabled }


Example Usage

python
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

Exact Signatures

Exact names, parameters, defaults, and returns are defined by GET /skills/schema or unity_skills.get_skill_schema(), not by this file.

© Besty0728, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in SkillsForUnity/unity-skills~/skills/shader of Besty0728/Unity-Skills.

Open the folder on GitHubat commit 12a40e4

Compare with similar skills

Unity Shader next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Unity Shader compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Unity Shader this skillBesty0728/Unity-Skills1.8k—~2.1kAutomated safety check: PassMIT
PixijsRSamaium/CanvasEngine4012 repos~1.6kAutomated safety check: PassMIT
New ExperimentTresjs/tres3.8k—~782Automated safety check: PassMIT
Assets Shader List AllIvanMurzak/Unity-MCP4.4k—~435Automated safety check: PassApache-2.0
Handle Sdr Tonemap Lutclshortfuse/renodx4.4k—~7.3kAutomated safety check: PassMIT
Unreal Material and VFX Workflowflopperam/unreal-engine-mcp1.1k—~927Automated safety check: PassNone

Similar skills

  • Pixijs

    RSamaium/CanvasEngine

    Use this skill first for ANY PixiJS v8 task; it routes to the right specialized skill for the job.

    401 GitHub starsUsed in 2 repos~1.6k tokens
    Game DevelopmentAuto-check passed
  • New Experiment

    Tresjs/tres

    Create a new experiment in TresJS Lab with all necessary files

    3.8k GitHub stars~782 tokensUpdated today
    Game DevelopmentAuto-check passed
  • Assets Shader List All

    IvanMurzak/Unity-MCP

    List all shaders available in the project assets and packages, sorted by name.

    4.4k GitHub stars~435 tokensUpdated 3 days ago
    Game DevelopmentAuto-check passed
  • Handle Sdr Tonemap Lut

    clshortfuse/renodx

    RenoDX HLSL/Slang shader workflow for proven shader-side SDR tonemap, hard clip, LUT, color grade, and HDR bridge changes.

    4.4k GitHub stars~7.3k tokensUpdated today
    Game DevelopmentAuto-check passed
  • Unreal Material and VFX Workflow

    flopperam/unreal-engine-mcp

    Walks an Unreal Engine MCP agent through building materials, Niagara particle systems, Chaos destruction, and curve assets with inspect-then-edit steps.

    1.1k GitHub stars~927 tokensUpdated 3 mo ago
    Game DevelopmentAuto-check passed
  • Rdc CLI

    BANANASJIM/rdc-cli

    A skill your agent uses when working with RenderDoc capture files (.rdc), analyzing GPU frames, tracing shaders, inspecting draw calls, or running CI assertions against GPU captures.

    180 GitHub stars~2.9k tokensUpdated 2 mo ago
    Game DevelopmentAuto-check passed

More from Besty0728/Unity-Skills

All 82 skills in this repo
  • Unity Skills

    Besty0728/Unity-Skills

    Automate the Unity Editor through a local REST API — scripts, scenes, prefabs, assets, materials, lighting, tests and hundreds of other Editor operations.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Unity Animator

    Besty0728/Unity-Skills

    Edit Unity Animator Controllers and drive runtime parameters

    1.8k GitHub stars~2.4k tokensUpdated yesterday
    Auto-check passed
  • Unity Architecture

    Besty0728/Unity-Skills

    Advise on Unity gameplay and system architecture. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~1.3k tokensUpdated yesterday
    Auto-check passed
  • Unity Batch

    Besty0728/Unity-Skills

    Unified batch and async-job orchestration. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~2k tokensUpdated yesterday
    Auto-check passed
  • Unity Behavior

    Besty0728/Unity-Skills

    Drive Unity Behavior behavior graphs and blackboard variables

    1.8k GitHub stars~3k tokensUpdated yesterday
    Auto-check passed
  • Unity Console

    Besty0728/Unity-Skills

    Capture and query the Unity Editor console. An agent skill from Besty0728/Unity-Skills.

    1.8k GitHub stars~1.8k tokensUpdated yesterday
    Auto-check passed

Questions about Unity Shader

How do I install Unity Shader in Claude Code?

Run `npx skills add Besty0728/Unity-Skills --skill unity-shader -a claude-code`. Or copy the skill folder (SkillsForUnity/unity-skills~/skills/shader in Besty0728/Unity-Skills) into .claude/skills/unity-shader in your project. Claude Code loads it when a task matches its description.

How do I install Unity Shader in Codex?

Run `npx skills add Besty0728/Unity-Skills --skill unity-shader -a codex`. Or copy the skill folder (SkillsForUnity/unity-skills~/skills/shader in Besty0728/Unity-Skills) into .agents/skills/unity-shader in your project. Codex loads it when a task matches its description.

Can I use Unity Shader in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Besty0728/Unity-Skills --skill unity-shader -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/unity-shader, .gemini/skills/unity-shader, .github/skills/unity-shader and .opencode/skills/unity-shader in your project.

What does Unity Shader need to run?

SKILL.md names no scripts, command-line tools or credentials: Unity Shader is instructions for the agent only.

Does Unity Shader access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Unity Shader safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Unity Shader use?

Unity Shader is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Unity Shader use?

About 2.1k tokens (SKILL.md is roughly 8.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Unity Shader?

Skills that share tags, products or a category with Unity Shader: Pixijs (RSamaium/CanvasEngine, 401 stars), New Experiment (Tresjs/tres, 3.8k stars), Assets Shader List All (IvanMurzak/Unity-MCP, 4.4k stars) and Handle Sdr Tonemap Lut (clshortfuse/renodx, 4.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Unity Shader?

Besty0728 (a GitHub user) maintains it in Besty0728/Unity-Skills, which has 1,814 GitHub stars. The repository holds 82 skills in this directory. The repository was last updated on October 6, 2026.

Source: Besty0728/Unity-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.