unity-shadergraph
Create and inspect Shader Graph assets
How do I install this agent skill?
npx skills add https://github.com/besty0728/unity-skills --skill unity-shadergraphIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a safe interface for managing Unity Shader Graph assets with strict validation rules and constrained tool usage within the Unity editor environment.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
Unity ShaderGraph Skills
Shader Graph asset workflows for Unity 2022.3+: template handling, MultiJson inspection and constrained internal-editor reflection writes. Parameters come from the schema (GET /skills/schema?names=<skill>&wire=v2); execution and dryRun rules: root SKILL.md.
When to use
- Creating a Shader Graph
- Inspecting graph structure
- Making controlled blackboard or node edits
Rules
- HLSL text shaders belong to the shader module. Load shadergraph-design before proposing graph architecture.
- Always call
shadergraph_get_structurebefore a node-level edit. Treat itsnodeIdandslotIdvalues as the only valid identifiers. - Never invent slot names, node ids or template names from memory. Confirm node types, settings and slot layout with
shadergraph_list_supported_nodes. shadergraph_set_node_defaultsapplies only to unconnected input slots; disconnect the slot first if it is connected.shadergraph_set_node_settingswrites only the whitelist thatshadergraph_list_supported_nodesexposes.- A
PropertyNodebinds only an existing blackboard property; create the property first withshadergraph_add_property. - SubGraph editing is limited to ordinary nodes; this module does not edit
SubGraphOutputNodestructure. - If an error mentions a reflection or type lookup failure, report the version mismatch and stop. Do not retry with different argument shapes.
- Internal types are pinned to
com.unity.shadergraph14.0.x (Unity 2022.3) with limited Unity 6 coverage. A package update that changes internal types or theMultiJsonschema can make mutators fail or silently no-op until the registry is updated. - Unity 2022.3 with
com.unity.shadergraph@14.0.12ships noGraphTemplates/;shadergraph_create_graphthen falls back to a blank graph. Unity 6 may provide template directories. - The supported node subset is filtered at runtime. In live validation 28 nodes overlapped;
AppendVectorNodeis Unity 6 only.
Pitfalls
- Reading structure first and then editing by
nodeIdavoids most failures. Re-readshadergraph_get_structureafter an edit when the next step depends on topology.
Skills
shadergraph_list_templates
List Shader Graph templates shipped by the installed package.
shadergraph_create_graph
Create a Shader Graph asset from a package template, or a blank graph as fallback.
shadergraph_create_subgraph
Create a blank Shader Sub Graph asset with a configured output slot.
shadergraph_list_assets
List Shader Graph and Sub Graph assets in the project.
shadergraph_get_info
Get a high-level summary of a Shader Graph or Sub Graph asset.
shadergraph_get_structure
Inspect the live graph structure. Returns real nodeId, position, slots, edges, properties and keywords.
shadergraph_list_supported_nodes
List the constrained node whitelist, supported versions, slots and editable settings.
shadergraph_add_node
Add a supported node by nodeType, with optional initial settings and position.
shadergraph_remove_node
Remove a node by its serialized nodeId; related edges are removed with it.
shadergraph_move_node
Move a node by its serialized nodeId.
shadergraph_connect_nodes
Connect an output slot to an input slot using nodeId and slotId.
shadergraph_disconnect_nodes
Disconnect one exact edge, using the same four-value tuple.
shadergraph_set_node_defaults
Set the default value of an unconnected input slot.
shadergraph_set_node_settings
Write whitelisted node settings only.
shadergraph_list_properties
List graph blackboard properties.
shadergraph_add_property
Add a constrained blackboard property.
shadergraph_update_property
Update a constrained blackboard property.
shadergraph_remove_property
Remove a graph property.
shadergraph_list_keywords
List graph blackboard keywords.
shadergraph_add_keyword
Add a graph keyword.
shadergraph_update_keyword
Update a graph keyword.
shadergraph_remove_keyword
Remove a graph keyword.
shadergraph_reimport
Force a reimport of a Shader Graph asset after external edits.
Workflow
- Create or locate the target graph.
- Read
shadergraph_get_structure. - Create blackboard properties or keywords first when the edit needs them.
- Confirm node type, settings whitelist and slot layout with
shadergraph_list_supported_nodes. - Add or move nodes, then connect or disconnect them by live
nodeIdandslotId.
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/besty0728/unity-skills/unity-shadergraph">View unity-shadergraph on skillZs</a>