unity-shadergraph

Create and edit Unity Shader Graph assets through constrained node and blackboard operations.

Updated Oct 13, 2025
One-click install
npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-shadergraph-darth-carrotpie
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-shadergraph
Source: https://github.com/Darth-Carrotpie/ProxyCore/tree/main/.agents/skills/unity-skills/skills/shadergraph
Command: npx skills add https://github.com/Darth-Carrotpie/ProxyCore --skill unity-shadergraph-darth-carrotpie

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually authoring Shader Graph assets in Unity requires navigating the editor UI for every node, connection, and blackboard entry, which is slow and error-prone for agents or automated workflows. This Skill exposes programmatic creation, inspection, and constrained editing of Shader Graph and Sub Graph assets. ## Core Features & Use Cases - Graph Creation and Inspection: Create Shader Graphs from package templates or blank fallbacks, create Sub Graphs, and inspect live structure including nodeIds, slots, edges, properties, and keywords. - Constrained Node Editing: Add, move, connect, disconnect, and configure nodes against a version-pinned whitelist of supported node types and settings. - Blackboard Management: Add, update, list, and remove blackboard properties and keywords before binding them to PropertyNodes. - Use Case: Ask the agent to build a lit Shader Graph with a texture sample and color property; it reads the live structure, creates the blackboard property, adds whitelisted nodes, and wires connections using real nodeId and slotId values. ## Quick Start Create a new Shader Graph asset named WaterShader, add a color property to its blackboard, and connect a sample node chain using the live graph structure.

Frequently Asked Questions about unity-shadergraph

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

FAQPage Schema
How do I create a Shader Graph asset programmatically in Unity?▼

Use shadergraph_create_graph to create a graph from a package template, with a blank-graph fallback when templates are unavailable. On Unity 2022.3 with shadergraph 14.0.x, templates are not shipped, so blank creation is the default path.

How do I connect nodes in a Unity Shader Graph?▼

Call shadergraph_get_structure first to obtain real nodeId and slotId values, then use shadergraph_connect_nodes with the output and input slot pair. Never invent slot names or node ids from memory.

Which Unity versions does Shader Graph editing support?▼

The supported node whitelist and reflection targets are pinned to com.unity.shadergraph 14.0.x on Unity 2022.3, with limited Unity 6 coverage. The shared validated node set is 28 nodes, with AppendVectorNode currently Unity 6 only.

Why does a Shader Graph edit fail after a package update?▼

The module relies on reflection into internal ShaderGraph types, so a package update can change type layouts or MultiJson schema and cause failures or silent no-ops. Report the version mismatch instead of retrying with different arguments.

Can I delete nodes or properties from a Shader Graph automatically?▼

Remove operations carry a Delete operation flag and are auto-forbidden in Approval and Auto modes. They only run under Bypass mode or through a user-managed allowlist.

When should I use HLSL shaders instead of Shader Graph?▼

Use the shader_* module for hand-written HLSL text shaders. This module is only for Shader Graph and Sub Graph assets, and it cannot edit SubGraphOutputNode structure.