unity-shadergraph

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

Updated May 20, 2026
One-click install
npx skills add https://github.com/yuse168/Roomies --skill unity-shadergraph-yuse168
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-shadergraph
Source: https://github.com/yuse168/Roomies/tree/main/.agents/skills/unity-skills/skills/shadergraph
Command: npx skills add https://github.com/yuse168/Roomies --skill unity-shadergraph-yuse168

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing Unity Shader Graph assets programmatically is fragile because the Shader Graph package exposes no stable public API for graph mutation, forcing developers to hand-edit serialized assets or click through the editor for every node, connection, and blackboard property change. ## Core Features & Use Cases - Graph Creation and Inspection: Create Shader Graph and Sub Graph assets from package templates or blank fallbacks, then inspect live structure including nodeIds, slotIds, edges, properties, and keywords. - Constrained Node Editing: Add, move, connect, disconnect, and remove nodes from a version-pinned whitelist, with settings writes limited to validated keys. - Blackboard Management: Add, update, list, and remove blackboard properties and keywords before binding them to PropertyNodes. - Use Case: A technical artist asks the AI to build a toon shading graph: the skill creates the graph, adds a Color property to the blackboard, adds Multiply and Sample Texture 2D nodes, connects them via live slotIds, and reimports the asset. ## Quick Start Create a new Shader Graph asset named ToonShading, add a Color property to its blackboard, and show me its 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 automatic fallback to blank graph creation when templates are unavailable. On Unity 2022.3 with shadergraph 14.0.12, no GraphTemplates directory ships, so blank creation is the default path.

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

Call shadergraph_get_structure first to obtain live nodeId and slotId values, then use shadergraph_connect_nodes with the output slot and input slot four-tuple. Never invent slot names or node ids from memory, as they are version-specific.

Which Unity versions does Shader Graph editing support?▼

The node whitelist, slot layout, and settings keys 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, and AppendVectorNode is currently Unity 6 only.

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

The module uses reflection into UnityEditor.ShaderGraph internals, so a package update that changes internal types or the MultiJson schema can cause mutators to fail or silently no-op. Do not retry with different arguments; report the version mismatch and stop.

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

Remove operations carry SkillOperation.Delete and are auto-forbidden in Approval and Auto modes. They only run under Bypass mode or through a user-managed allowlist, preventing accidental destructive edits.

What are the limitations of editing Shader Sub Graphs?▼

Sub Graph editing is limited to ordinary nodes; the module does not edit SubGraphOutputNode structure. PropertyNodes only bind existing blackboard properties, so create the property with shadergraph_add_property before binding it.