unity-shadergraph

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

Updated Jan 29, 2026
One-click install
npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-shadergraph-dylan8865
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unity-shadergraph
Source: https://github.com/Dylan8865/FinalYearProject/tree/main/GameDev/Tester/.agents/skills/unity-skills/skills/shadergraph
Command: npx skills add https://github.com/Dylan8865/FinalYearProject --skill unity-shadergraph-dylan8865

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Editing Unity Shader Graph assets programmatically is fragile because the ShaderGraph package exposes internal editor APIs that change between versions. This Skill provides a controlled, whitelist-based interface for creating graphs, inspecting their structure, and making safe node and blackboard edits without guessing internal type layouts. ## Core Features & Use Cases - Graph Creation and Inspection: Create Shader Graph and Sub Graph assets from templates or blank fallbacks, then inspect live structure including nodeIds, slots, edges, properties, and keywords. - Constrained Node Editing: Add, move, connect, disconnect, and configure nodes using a version-pinned whitelist of supported node types and settings. - Blackboard Management: Add, update, list, and remove blackboard properties and keywords that drive graph behavior. - Use Case: A technical artist asks the AI to build a toon-shading graph: the Skill creates the graph, adds a property for base color, adds multiply and fresnel nodes from the supported whitelist, connects them via live slot IDs, and reimports the asset. ## Quick Start Create a new Shader Graph asset named ToonShading, add a Color property, and connect a Multiply node to the fragment output.

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 in Unity programmatically?▼

Use shadergraph_create_graph to create a graph from a package template or a blank fallback, then call shadergraph_get_structure to read its live nodeIds and slots before making any edits. Template availability depends on the installed Shader Graph package version.

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 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 supported node whitelist and internal type mappings are pinned to com.unity.shadergraph 14.0.x on Unity 2022.3, with limited Unity 6 coverage. If the package updates change internal types, mutators may fail until the registry is updated.

Why does a Shader Graph edit fail with a reflection or type lookup error?▼

Reflection errors mean the installed Shader Graph package changed internal types or MultiJson schema that the whitelist depends on. Do not retry with different arguments; report the version mismatch and stop until the registry is updated.

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

Removal operations like shadergraph_remove_node and shadergraph_remove_property carry delete semantics and are auto-forbidden in Approval and Auto modes. They only run under Bypass mode or an explicit user-managed allowlist.

What are the limitations of Shader Graph node editing?▼

Only whitelisted node types and settings can be written, node defaults apply only to unconnected input slots, and SubGraph editing excludes SubGraphOutputNode structure. Always verify capabilities with shadergraph_list_supported_nodes before editing.