# shader-graph-create-custom-node

Generates custom Shader Graph nodes directly from HLSL functions. It handles reflection markup so Unity registers your shader code in the graph creation menu.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5600 installs · ★ 1149
- Author: Unity-Technologies
- License: LicenseRef-Unknown · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Unity-Technologies/skills/tree/HEAD/skills/shader-graph-create-custom-node/SKILL.md
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/skills/shader-graph-create-custom-node

## What it does

The skill automates the creation of Shader Graph nodes using Unity reflection metadata. It prepends your HLSL function with `UNITY_EXPORT_REFLECTION` and applies the mandatory hint tags: display name, category, provider key, and search terms. Documentation in C# style can be included outside hint blocks.

Once the code is prepared, the skill targets a `.hlsl` asset. It checks the project for existing `ShaderInclude` files that already host custom nodes, showing the content to ask for confirmation before modifying anything. If no suitable file exists, it generates a fresh `.hlsl` asset headed by `#include "ShaderApiReflectionSupport.hlsl"`.

Your Unity project must have the `com.unity.shadergraph` package at version 17.5.0 or newer. Without this minimum version, the reflection workflow fails to expose your HLSL functions inside the graph editor.

## Requirements
- Works with: Unity

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill shader-graph-create-custom-node -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/shader-graph-create-custom-node/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/shader-graph-create-custom-node/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill shader-graph-create-custom-node -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/shader-graph-create-custom-node/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill shader-graph-create-custom-node -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/shader-graph-create-custom-node/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Unity-Technologies/skills shader-graph-create-custom-node
```

2. **Manually: put the files in place**
- File: `.github/skills/shader-graph-create-custom-node/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill shader-graph-create-custom-node -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/Unity-Technologies/skills --path skills/shader-graph-create-custom-node
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/shader-graph-create-custom-node/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add Unity-Technologies/skills --skill shader-graph-create-custom-node -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/Unity-Technologies/skills/tree/HEAD/skills/shader-graph-create-custom-node/SKILL.md

## When to use it
- convert existing HLSL functions into reflected Shader Graph nodes
- annotate HLSL code with search keywords and category hints for Unity
- append new custom node definitions to existing ShaderInclude assets
- scaffold a new HLSL include file with reflection support headers

## Example prompts
- Turn this HLSL noise function into a custom Shader Graph node named SimplexNoise
- Expose my color correction HLSL helper as a reflected node in the Color category
- Generate a custom Shader Graph node from this HLSL code and save it to our ShaderInclude asset

## Similar
- [shader-programming](https://affpapa.org/en/nevibecode/skills/shader-programming.md) — skill · 6900 installs
- [slang-shader-engineer](https://affpapa.org/en/nevibecode/skills/slang-shader-engineer.md) — skill · 43 installs
- [shader-dev](https://affpapa.org/en/nevibecode/skills/shader-dev.md) — skill · 2800 installs
- [shader-glsl](https://affpapa.org/en/nevibecode/skills/shader-glsl.md) — skill · 1400 installs
- [metal-shader-expert](https://affpapa.org/en/nevibecode/skills/metal-shader-expert.md) — skill · 512 installs
- [flue](https://affpapa.org/en/nevibecode/skills/flue.md) — skill · 12600 installs

From the same set: [unity-technologies/skills](https://affpapa.org/en/nevibecode/by/unity-technologies/skills.md) — 28 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md