[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M7FA4JYW5ZXC133TCDC95GGP":3,"skill-same:01M7FA4JYW5ZXC133TCDC95GGP":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":13,"repositoryHtmlUrl":31,"repositoryHomepageUrl":6,"ownerHtmlUrl":32,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":33,"install":34,"resources":47},"01M7FA4JYW5ZXC133TCDC95GGP","blender-syntax-nodes",null,"Use when building node trees via Python -- Geometry Nodes, Shader Nodes, or Compositor Nodes. Prevents the breaking change of using node.inputs\u002Foutputs by index instead of NodeTreeInterface (4.0+) for node group I\u002FO. Covers node creation, linking, group management, and the NodeTreeInterface API migration. Keywords: node tree, Geometry Nodes, Shader Nodes, Compositor, NodeTreeInterface, node_group, links, nodes.new, node sockets, procedural geometry, create nodes from Python, connect nodes, add node.","lagzgabrielmuller-dot\u002Fkit-ingenieria-3d","lagzgabrielmuller-dot","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F333339260?v=4","01M7F985KYC0XB2XZ97B5YWH4C","01M7F985MHK8N2NVE4VAR5WBWS",0,"MIT","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes\u002FSKILL.md",[],[],"2026-11-16 10:05:34",false,"---\nname: blender-syntax-nodes\ndescription: >\n  Use when building node trees via Python -- Geometry Nodes, Shader Nodes, or Compositor\n  Nodes. Prevents the breaking change of using node.inputs\u002Foutputs by index instead of\n  NodeTreeInterface (4.0+) for node group I\u002FO. Covers node creation, linking, group\n  management, and the NodeTreeInterface API migration.\n  Keywords: node tree, Geometry Nodes, Shader Nodes, Compositor, NodeTreeInterface, node_group, links, nodes.new, node sockets, procedural geometry, create nodes from Python, connect nodes, add node.\nlicense: MIT\ncompatibility: \"Designed for Claude Code. Requires Blender 3.x\u002F4.x\u002F5.x with Python.\"\nmetadata:\n  author: OpenAEC-Foundation\n  version: \"1.0\"\n---\n\n# blender-syntax-nodes\n\n## Quick Reference\n\n### Critical Warnings\n\n**NEVER** use `node_group.inputs.new()` or `node_group.outputs.new()` in Blender 4.0+ — these are removed. ALWAYS use `node_group.interface.new_socket()`.\n\n**NEVER** access node sockets by index (`node.inputs[0]`) — indices shift when sockets are added or removed. ALWAYS use `node.inputs[\"Name\"]`.\n\n**NEVER** use `scene.node_tree` for compositor access in Blender 5.0+ — it is removed. ALWAYS use `scene.compositing_node_group`.\n\n**NEVER** set modifier inputs by socket name (`modifier[\"Width\"]`) — modifier inputs use auto-generated identifiers (`Socket_N`). ALWAYS iterate `interface.items_tree` to find the correct identifier.\n\n**NEVER** modify node trees during an active render — race conditions with the render thread cause crashes. ALWAYS modify nodes before render starts.\n\n### Node Tree Architecture\n\nAll node systems in Blender share this architecture:\n\n```\nNodeTree\n├── nodes: Collection[Node]        — all nodes in the tree\n├── links: Collection[NodeLink]    — connections between sockets\n└── interface: NodeTreeInterface   — group inputs\u002Foutputs (4.0+)\n\nNode\n├── inputs: Collection[NodeSocket]   — input sockets\n├── outputs: Collection[NodeSocket]  — output sockets\n├── location: (x, y)                 — position in editor\n└── name \u002F label \u002F bl_idname         — identification\n\nNodeLink\n├── from_node \u002F from_socket          — source\n└── to_node \u002F to_socket              — destination\n\nNodeSocket\n├── name \u002F identifier                — naming\n├── type                             — data type enum\n├── is_linked                        — connection state\n└── default_value                    — value when unconnected\n```\n\n### Node Tree Types\n\n| `type` Parameter | Purpose | Access Pattern |\n|-----------------|---------|----------------|\n| `'GeometryNodeTree'` | Geometry Nodes | `bpy.data.node_groups.new(name, 'GeometryNodeTree')` |\n| `'ShaderNodeTree'` | Material\u002FWorld shaders | `material.node_tree` or `bpy.data.node_groups.new(name, 'ShaderNodeTree')` |\n| `'CompositorNodeTree'` | Compositor | `scene.node_tree` (3.x\u002F4.x) or `scene.compositing_node_group` (5.0+) |\n| `'TextureNodeTree'` | Legacy texture nodes | `bpy.data.node_groups.new(name, 'TextureNodeTree')` |\n| `'SverchCustomTreeType'` | Sverchok parametric nodes (third-party addon) | `bpy.data.node_groups` (filter by `bl_idname=='SverchCustomTreeType'`). Requires Sverchok addon enabled. See `sverchok-core-concepts` skill. |\n\n### Decision Tree: Which Node API?\n\n```\nQ: Are you creating a node GROUP (reusable)?\n├── YES → bpy.data.node_groups.new(name, tree_type)\n│         Then: group.interface.new_socket() for inputs\u002Foutputs (4.0+)\n└── NO → What node tree type?\n    ├── Shader → material.use_nodes = True; tree = material.node_tree\n    ├── Compositor (3.x\u002F4.x) → scene.use_nodes = True; tree = scene.node_tree\n    ├── Compositor (5.0+) → tree = bpy.data.node_groups.new(name, 'CompositorNodeTree')\n    │                        scene.compositing_node_group = tree\n    └── Geometry Nodes → Create group, assign to modifier\n```\n\n### Decision Tree: Socket Interface (Version-Critical)\n\n```\nQ: What Blender version?\n├── 3.x → node_group.inputs.new(socket_type, name)\n│         node_group.outputs.new(socket_type, name)\n├── 4.0+ → node_group.interface.new_socket(name=, in_out=, socket_type=)\n└── 4.1+ → Also supports: node_group.interface.new_panel(name)\n           with parent= parameter on new_socket()\n```\n\n---\n\n## Essential Patterns\n\n### Pattern 1: Creating a Node Group (Blender 4.0+)\n\n```python\nimport bpy\n\n# Create the node group\ngroup = bpy.data.node_groups.new(\"MyNodeGroup\", 'GeometryNodeTree')\ngroup.nodes.clear()\n\n# Add Group Input\u002FOutput nodes\ninput_node = group.nodes.new('NodeGroupInput')\ninput_node.location = (-300, 0)\noutput_node = group.nodes.new('NodeGroupOutput')\noutput_node.location = (300, 0)\n\n# Define interface sockets (4.0+)\ngroup.interface.new_socket(name=\"Geometry\", in_out='INPUT', socket_type='NodeSocketGeometry')\ngroup.interface.new_socket(name=\"Scale\", in_out='INPUT', socket_type='NodeSocketFloat')\ngroup.interface.new_socket(name=\"Geometry\", in_out='OUTPUT', socket_type='NodeSocketGeometry')\n```\n\n### Pattern 2: Creating and Linking Nodes\n\n```python\n# Add nodes\ntransform = group.nodes.new('GeometryNodeTransform')\ntransform.location = (0, 0)\n\n# Link: source output -> destination input\ngroup.links.new(input_node.outputs[\"Geometry\"], transform.inputs[\"Geometry\"])\ngroup.links.new(input_node.outputs[\"Scale\"], transform.inputs[\"Scale\"])\ngroup.links.new(transform.outputs[\"Geometry\"], output_node.inputs[\"Geometry\"])\n```\n\n### Pattern 3: Shader Node Material\n\n```python\nmat = bpy.data.materials.new(\"MyMaterial\")\nmat.use_nodes = True\ntree = mat.node_tree\ntree.nodes.clear()\n\n# Add nodes\nprincipled = tree.nodes.new('ShaderNodeBsdfPrincipled')\nprincipled.location = (0, 0)\noutput = tree.nodes.new('ShaderNodeOutputMaterial')\noutput.location = (300, 0)\n\n# Link\ntree.links.new(principled.outputs[\"BSDF\"], output.inputs[\"Surface\"])\n\n# Set values on unlinked sockets\nprincipled.inputs[\"Base Color\"].default_value = (0.8, 0.2, 0.1, 1.0)\nprincipled.inputs[\"Roughness\"].default_value = 0.4\n```\n\n### Pattern 4: Assigning Geometry Nodes to Object\n\n```python\nobj = bpy.context.active_object\nmodifier = obj.modifiers.new(name=\"GeoNodes\", type='NODES')\nmodifier.node_group = bpy.data.node_groups[\"MyNodeGroup\"]\n\n# Set modifier input values: MUST find identifier first\nfor item in modifier.node_group.interface.items_tree:\n    if item.item_type == 'SOCKET' and item.in_out == 'INPUT':\n        if item.name == \"Scale\":\n            modifier[item.identifier] = 2.5\n            break\n```\n\n### Pattern 5: Compositor Nodes (Version-Aware)\n\n```python\nimport bpy\n\nscene = bpy.context.scene\n\nif bpy.app.version >= (5, 0, 0):\n    # Blender 5.0+: compositor uses node groups\n    comp_tree = bpy.data.node_groups.new(\"MyCompositor\", 'CompositorNodeTree')\n    scene.compositing_node_group = comp_tree\nelse:\n    # Blender 3.x\u002F4.x: compositor on scene\n    scene.use_nodes = True\n    comp_tree = scene.node_tree\n\ncomp_tree.nodes.clear()\n\nrender_layers = comp_tree.nodes.new('CompositorNodeRLayers')\nrender_layers.location = (-300, 0)\ncomposite = comp_tree.nodes.new('CompositorNodeComposite')\ncomposite.location = (300, 0)\n\ncomp_tree.links.new(render_layers.outputs[\"Image\"], composite.inputs[\"Image\"])\n```\n\n### Pattern 6: Interface Panels (Blender 4.1+)\n\n```python\n# Group sockets into collapsible panels\ngroup = bpy.data.node_groups[\"MyNodeGroup\"]\n\npanel = group.interface.new_panel(\"Dimensions\")\ngroup.interface.new_socket(\n    name=\"Width\", in_out='INPUT',\n    socket_type='NodeSocketFloat', parent=panel\n)\ngroup.interface.new_socket(\n    name=\"Height\", in_out='INPUT',\n    socket_type='NodeSocketFloat', parent=panel\n)\n```\n\n---\n\n## Common Operations\n\n### Adding Common Node Types\n\n**Geometry Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'GeometryNodeMeshCube'` | Cube mesh primitive |\n| `'GeometryNodeMeshCylinder'` | Cylinder mesh primitive |\n| `'GeometryNodeMeshGrid'` | Grid mesh primitive |\n| `'GeometryNodeMeshLine'` | Line mesh primitive |\n| `'GeometryNodeTransform'` | Transform geometry |\n| `'GeometryNodeSetPosition'` | Set vertex positions |\n| `'GeometryNodeJoinGeometry'` | Merge geometries |\n| `'GeometryNodeInstanceOnPoints'` | Instance objects on points |\n| `'GeometryNodeCurvePrimitiveLine'` | Curve line |\n| `'GeometryNodeExtrudeMesh'` | Extrude mesh faces\u002Fedges |\n| `'GeometryNodeBooleanMath'` | Boolean operations |\n| `'GeometryNodeInputPosition'` | Read position attribute |\n| `'GeometryNodeStoreNamedAttribute'` | Write custom attribute |\n| `'FunctionNodeInputVector'` | Vector input value |\n| `'ShaderNodeMath'` | Math operations (shared) |\n| `'ShaderNodeVectorMath'` | Vector math (shared) |\n\n**Shader Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'ShaderNodeBsdfPrincipled'` | Principled BSDF shader |\n| `'ShaderNodeOutputMaterial'` | Material output |\n| `'ShaderNodeTexImage'` | Image texture |\n| `'ShaderNodeTexNoise'` | Noise texture |\n| `'ShaderNodeTexCoord'` | Texture coordinates |\n| `'ShaderNodeMapping'` | Vector mapping |\n| `'ShaderNodeMixRGB'` | Color mix (3.x) |\n| `'ShaderNodeMix'` | Mix node (4.0+, replaces MixRGB) |\n| `'ShaderNodeNormalMap'` | Normal map |\n| `'ShaderNodeBump'` | Bump mapping |\n| `'ShaderNodeValToRGB'` | Color ramp |\n| `'ShaderNodeSeparateXYZ'` | Split vector components |\n| `'ShaderNodeCombineXYZ'` | Combine vector components |\n\n**Compositor Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'CompositorNodeRLayers'` | Render Layers input |\n| `'CompositorNodeComposite'` | Final composite output |\n| `'CompositorNodeViewer'` | Viewer node |\n| `'CompositorNodeMixRGB'` | Mix colors |\n| `'CompositorNodeBlur'` | Blur filter |\n| `'CompositorNodeGlare'` | Glare effect |\n| `'CompositorNodeColorBalance'` | Color balance |\n\n### Common Socket Types\n\n| Socket Type String | Data Type | Default Value Type |\n|-------------------|-----------|-------------------|\n| `'NodeSocketFloat'` | Single float | `float` |\n| `'NodeSocketInt'` | Integer | `int` |\n| `'NodeSocketBool'` | Boolean | `bool` |\n| `'NodeSocketVector'` | 3D vector | `(float, float, float)` |\n| `'NodeSocketColor'` | RGBA color | `(float, float, float, float)` |\n| `'NodeSocketString'` | String | `str` |\n| `'NodeSocketGeometry'` | Geometry data | N\u002FA (link-only) |\n| `'NodeSocketMaterial'` | Material ref | `Material` or `None` |\n| `'NodeSocketObject'` | Object ref | `Object` or `None` |\n| `'NodeSocketCollection'` | Collection ref | `Collection` or `None` |\n| `'NodeSocketImage'` | Image ref | `Image` or `None` |\n| `'NodeSocketShader'` | Shader closure | N\u002FA (link-only) |\n\n### Removing Nodes and Links\n\n```python\n# Remove a specific node\ntree.nodes.remove(tree.nodes[\"NodeName\"])\n\n# Remove a specific link\nfor link in tree.links:\n    if link.from_node.name == \"Source\" and link.to_node.name == \"Dest\":\n        tree.links.remove(link)\n        break\n\n# Clear all nodes\ntree.nodes.clear()\n\n# Clear all links (keeps nodes)\ntree.links.clear()\n```\n\n### Setting Socket Default Values\n\n```python\n# Set value on an UNLINKED input socket\nnode.inputs[\"Value\"].default_value = 1.5\nnode.inputs[\"Vector\"].default_value = (1.0, 2.0, 3.0)\nnode.inputs[\"Color\"].default_value = (1.0, 0.0, 0.0, 1.0)\n\n# Check if socket is linked before setting default\nif not node.inputs[\"Value\"].is_linked:\n    node.inputs[\"Value\"].default_value = 1.5\n```\n\n### Node Layout and Organization\n\n```python\n# Position nodes for readability\nnode_a.location = (-300, 0)\nnode_b.location = (0, 0)\nnode_c.location = (300, 0)\n\n# Add a frame for visual grouping\nframe = tree.nodes.new('NodeFrame')\nframe.label = \"Processing Stage\"\nframe.use_custom_color = True\nframe.color = (0.2, 0.4, 0.6)\n\n# Parent nodes to frame\nnode_a.parent = frame\nnode_b.parent = frame\n\n# Mute a node (bypass it)\nnode_b.mute = True\n\n# Hide a node (collapse)\nnode_b.hide = True\n```\n\n---\n\n## Version Migration Matrix\n\n| Feature | Blender 3.x | Blender 4.0+ | Blender 5.0+ |\n|---------|-------------|--------------|---------------|\n| Group socket creation | `group.inputs.new()` \u002F `group.outputs.new()` | `group.interface.new_socket()` | `group.interface.new_socket()` |\n| Interface panels | Not available | Not available | Available (added 4.1) |\n| Compositor tree access | `scene.node_tree` | `scene.node_tree` | `scene.compositing_node_group` |\n| `scene.use_nodes` (compositor) | Required | Required | Deprecated (always True) |\n| Mix node | `ShaderNodeMixRGB` | `ShaderNodeMix` (new) | `ShaderNodeMix` |\n| Shader name `3D_UNIFORM_COLOR` | Valid | Removed — use `UNIFORM_COLOR` | Use `UNIFORM_COLOR` |\n\n---\n\n## Reference Links\n\n- [references\u002Fmethods.md](references\u002Fmethods.md) — Complete API signatures for NodeTree, NodeTreeInterface, Node, NodeSocket, NodeLink\n- [references\u002Fexamples.md](references\u002Fexamples.md) — Working code examples for all node tree types\n- [references\u002Fanti-patterns.md](references\u002Fanti-patterns.md) — What NOT to do with node trees\n\n### Official Sources\n\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeTree.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeTreeInterface.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.Node.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeSocket.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeLink.html\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F4.0\u002Fpython_api\u002F\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F5.0\u002Fpython_api\u002F\n","# blender-syntax-nodes\n\n## Quick Reference\n\n### Critical Warnings\n\n**NEVER** use `node_group.inputs.new()` or `node_group.outputs.new()` in Blender 4.0+ — these are removed. ALWAYS use `node_group.interface.new_socket()`.\n\n**NEVER** access node sockets by index (`node.inputs[0]`) — indices shift when sockets are added or removed. ALWAYS use `node.inputs[\"Name\"]`.\n\n**NEVER** use `scene.node_tree` for compositor access in Blender 5.0+ — it is removed. ALWAYS use `scene.compositing_node_group`.\n\n**NEVER** set modifier inputs by socket name (`modifier[\"Width\"]`) — modifier inputs use auto-generated identifiers (`Socket_N`). ALWAYS iterate `interface.items_tree` to find the correct identifier.\n\n**NEVER** modify node trees during an active render — race conditions with the render thread cause crashes. ALWAYS modify nodes before render starts.\n\n### Node Tree Architecture\n\nAll node systems in Blender share this architecture:\n\n```\nNodeTree\n├── nodes: Collection[Node]        — all nodes in the tree\n├── links: Collection[NodeLink]    — connections between sockets\n└── interface: NodeTreeInterface   — group inputs\u002Foutputs (4.0+)\n\nNode\n├── inputs: Collection[NodeSocket]   — input sockets\n├── outputs: Collection[NodeSocket]  — output sockets\n├── location: (x, y)                 — position in editor\n└── name \u002F label \u002F bl_idname         — identification\n\nNodeLink\n├── from_node \u002F from_socket          — source\n└── to_node \u002F to_socket              — destination\n\nNodeSocket\n├── name \u002F identifier                — naming\n├── type                             — data type enum\n├── is_linked                        — connection state\n└── default_value                    — value when unconnected\n```\n\n### Node Tree Types\n\n| `type` Parameter | Purpose | Access Pattern |\n|-----------------|---------|----------------|\n| `'GeometryNodeTree'` | Geometry Nodes | `bpy.data.node_groups.new(name, 'GeometryNodeTree')` |\n| `'ShaderNodeTree'` | Material\u002FWorld shaders | `material.node_tree` or `bpy.data.node_groups.new(name, 'ShaderNodeTree')` |\n| `'CompositorNodeTree'` | Compositor | `scene.node_tree` (3.x\u002F4.x) or `scene.compositing_node_group` (5.0+) |\n| `'TextureNodeTree'` | Legacy texture nodes | `bpy.data.node_groups.new(name, 'TextureNodeTree')` |\n| `'SverchCustomTreeType'` | Sverchok parametric nodes (third-party addon) | `bpy.data.node_groups` (filter by `bl_idname=='SverchCustomTreeType'`). Requires Sverchok addon enabled. See `sverchok-core-concepts` skill. |\n\n### Decision Tree: Which Node API?\n\n```\nQ: Are you creating a node GROUP (reusable)?\n├── YES → bpy.data.node_groups.new(name, tree_type)\n│         Then: group.interface.new_socket() for inputs\u002Foutputs (4.0+)\n└── NO → What node tree type?\n    ├── Shader → material.use_nodes = True; tree = material.node_tree\n    ├── Compositor (3.x\u002F4.x) → scene.use_nodes = True; tree = scene.node_tree\n    ├── Compositor (5.0+) → tree = bpy.data.node_groups.new(name, 'CompositorNodeTree')\n    │                        scene.compositing_node_group = tree\n    └── Geometry Nodes → Create group, assign to modifier\n```\n\n### Decision Tree: Socket Interface (Version-Critical)\n\n```\nQ: What Blender version?\n├── 3.x → node_group.inputs.new(socket_type, name)\n│         node_group.outputs.new(socket_type, name)\n├── 4.0+ → node_group.interface.new_socket(name=, in_out=, socket_type=)\n└── 4.1+ → Also supports: node_group.interface.new_panel(name)\n           with parent= parameter on new_socket()\n```\n\n---\n\n## Essential Patterns\n\n### Pattern 1: Creating a Node Group (Blender 4.0+)\n\n```python\nimport bpy\n\n# Create the node group\ngroup = bpy.data.node_groups.new(\"MyNodeGroup\", 'GeometryNodeTree')\ngroup.nodes.clear()\n\n# Add Group Input\u002FOutput nodes\ninput_node = group.nodes.new('NodeGroupInput')\ninput_node.location = (-300, 0)\noutput_node = group.nodes.new('NodeGroupOutput')\noutput_node.location = (300, 0)\n\n# Define interface sockets (4.0+)\ngroup.interface.new_socket(name=\"Geometry\", in_out='INPUT', socket_type='NodeSocketGeometry')\ngroup.interface.new_socket(name=\"Scale\", in_out='INPUT', socket_type='NodeSocketFloat')\ngroup.interface.new_socket(name=\"Geometry\", in_out='OUTPUT', socket_type='NodeSocketGeometry')\n```\n\n### Pattern 2: Creating and Linking Nodes\n\n```python\n# Add nodes\ntransform = group.nodes.new('GeometryNodeTransform')\ntransform.location = (0, 0)\n\n# Link: source output -> destination input\ngroup.links.new(input_node.outputs[\"Geometry\"], transform.inputs[\"Geometry\"])\ngroup.links.new(input_node.outputs[\"Scale\"], transform.inputs[\"Scale\"])\ngroup.links.new(transform.outputs[\"Geometry\"], output_node.inputs[\"Geometry\"])\n```\n\n### Pattern 3: Shader Node Material\n\n```python\nmat = bpy.data.materials.new(\"MyMaterial\")\nmat.use_nodes = True\ntree = mat.node_tree\ntree.nodes.clear()\n\n# Add nodes\nprincipled = tree.nodes.new('ShaderNodeBsdfPrincipled')\nprincipled.location = (0, 0)\noutput = tree.nodes.new('ShaderNodeOutputMaterial')\noutput.location = (300, 0)\n\n# Link\ntree.links.new(principled.outputs[\"BSDF\"], output.inputs[\"Surface\"])\n\n# Set values on unlinked sockets\nprincipled.inputs[\"Base Color\"].default_value = (0.8, 0.2, 0.1, 1.0)\nprincipled.inputs[\"Roughness\"].default_value = 0.4\n```\n\n### Pattern 4: Assigning Geometry Nodes to Object\n\n```python\nobj = bpy.context.active_object\nmodifier = obj.modifiers.new(name=\"GeoNodes\", type='NODES')\nmodifier.node_group = bpy.data.node_groups[\"MyNodeGroup\"]\n\n# Set modifier input values: MUST find identifier first\nfor item in modifier.node_group.interface.items_tree:\n    if item.item_type == 'SOCKET' and item.in_out == 'INPUT':\n        if item.name == \"Scale\":\n            modifier[item.identifier] = 2.5\n            break\n```\n\n### Pattern 5: Compositor Nodes (Version-Aware)\n\n```python\nimport bpy\n\nscene = bpy.context.scene\n\nif bpy.app.version >= (5, 0, 0):\n    # Blender 5.0+: compositor uses node groups\n    comp_tree = bpy.data.node_groups.new(\"MyCompositor\", 'CompositorNodeTree')\n    scene.compositing_node_group = comp_tree\nelse:\n    # Blender 3.x\u002F4.x: compositor on scene\n    scene.use_nodes = True\n    comp_tree = scene.node_tree\n\ncomp_tree.nodes.clear()\n\nrender_layers = comp_tree.nodes.new('CompositorNodeRLayers')\nrender_layers.location = (-300, 0)\ncomposite = comp_tree.nodes.new('CompositorNodeComposite')\ncomposite.location = (300, 0)\n\ncomp_tree.links.new(render_layers.outputs[\"Image\"], composite.inputs[\"Image\"])\n```\n\n### Pattern 6: Interface Panels (Blender 4.1+)\n\n```python\n# Group sockets into collapsible panels\ngroup = bpy.data.node_groups[\"MyNodeGroup\"]\n\npanel = group.interface.new_panel(\"Dimensions\")\ngroup.interface.new_socket(\n    name=\"Width\", in_out='INPUT',\n    socket_type='NodeSocketFloat', parent=panel\n)\ngroup.interface.new_socket(\n    name=\"Height\", in_out='INPUT',\n    socket_type='NodeSocketFloat', parent=panel\n)\n```\n\n---\n\n## Common Operations\n\n### Adding Common Node Types\n\n**Geometry Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'GeometryNodeMeshCube'` | Cube mesh primitive |\n| `'GeometryNodeMeshCylinder'` | Cylinder mesh primitive |\n| `'GeometryNodeMeshGrid'` | Grid mesh primitive |\n| `'GeometryNodeMeshLine'` | Line mesh primitive |\n| `'GeometryNodeTransform'` | Transform geometry |\n| `'GeometryNodeSetPosition'` | Set vertex positions |\n| `'GeometryNodeJoinGeometry'` | Merge geometries |\n| `'GeometryNodeInstanceOnPoints'` | Instance objects on points |\n| `'GeometryNodeCurvePrimitiveLine'` | Curve line |\n| `'GeometryNodeExtrudeMesh'` | Extrude mesh faces\u002Fedges |\n| `'GeometryNodeBooleanMath'` | Boolean operations |\n| `'GeometryNodeInputPosition'` | Read position attribute |\n| `'GeometryNodeStoreNamedAttribute'` | Write custom attribute |\n| `'FunctionNodeInputVector'` | Vector input value |\n| `'ShaderNodeMath'` | Math operations (shared) |\n| `'ShaderNodeVectorMath'` | Vector math (shared) |\n\n**Shader Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'ShaderNodeBsdfPrincipled'` | Principled BSDF shader |\n| `'ShaderNodeOutputMaterial'` | Material output |\n| `'ShaderNodeTexImage'` | Image texture |\n| `'ShaderNodeTexNoise'` | Noise texture |\n| `'ShaderNodeTexCoord'` | Texture coordinates |\n| `'ShaderNodeMapping'` | Vector mapping |\n| `'ShaderNodeMixRGB'` | Color mix (3.x) |\n| `'ShaderNodeMix'` | Mix node (4.0+, replaces MixRGB) |\n| `'ShaderNodeNormalMap'` | Normal map |\n| `'ShaderNodeBump'` | Bump mapping |\n| `'ShaderNodeValToRGB'` | Color ramp |\n| `'ShaderNodeSeparateXYZ'` | Split vector components |\n| `'ShaderNodeCombineXYZ'` | Combine vector components |\n\n**Compositor Nodes:**\n\n| Node Type String | Purpose |\n|-----------------|---------|\n| `'CompositorNodeRLayers'` | Render Layers input |\n| `'CompositorNodeComposite'` | Final composite output |\n| `'CompositorNodeViewer'` | Viewer node |\n| `'CompositorNodeMixRGB'` | Mix colors |\n| `'CompositorNodeBlur'` | Blur filter |\n| `'CompositorNodeGlare'` | Glare effect |\n| `'CompositorNodeColorBalance'` | Color balance |\n\n### Common Socket Types\n\n| Socket Type String | Data Type | Default Value Type |\n|-------------------|-----------|-------------------|\n| `'NodeSocketFloat'` | Single float | `float` |\n| `'NodeSocketInt'` | Integer | `int` |\n| `'NodeSocketBool'` | Boolean | `bool` |\n| `'NodeSocketVector'` | 3D vector | `(float, float, float)` |\n| `'NodeSocketColor'` | RGBA color | `(float, float, float, float)` |\n| `'NodeSocketString'` | String | `str` |\n| `'NodeSocketGeometry'` | Geometry data | N\u002FA (link-only) |\n| `'NodeSocketMaterial'` | Material ref | `Material` or `None` |\n| `'NodeSocketObject'` | Object ref | `Object` or `None` |\n| `'NodeSocketCollection'` | Collection ref | `Collection` or `None` |\n| `'NodeSocketImage'` | Image ref | `Image` or `None` |\n| `'NodeSocketShader'` | Shader closure | N\u002FA (link-only) |\n\n### Removing Nodes and Links\n\n```python\n# Remove a specific node\ntree.nodes.remove(tree.nodes[\"NodeName\"])\n\n# Remove a specific link\nfor link in tree.links:\n    if link.from_node.name == \"Source\" and link.to_node.name == \"Dest\":\n        tree.links.remove(link)\n        break\n\n# Clear all nodes\ntree.nodes.clear()\n\n# Clear all links (keeps nodes)\ntree.links.clear()\n```\n\n### Setting Socket Default Values\n\n```python\n# Set value on an UNLINKED input socket\nnode.inputs[\"Value\"].default_value = 1.5\nnode.inputs[\"Vector\"].default_value = (1.0, 2.0, 3.0)\nnode.inputs[\"Color\"].default_value = (1.0, 0.0, 0.0, 1.0)\n\n# Check if socket is linked before setting default\nif not node.inputs[\"Value\"].is_linked:\n    node.inputs[\"Value\"].default_value = 1.5\n```\n\n### Node Layout and Organization\n\n```python\n# Position nodes for readability\nnode_a.location = (-300, 0)\nnode_b.location = (0, 0)\nnode_c.location = (300, 0)\n\n# Add a frame for visual grouping\nframe = tree.nodes.new('NodeFrame')\nframe.label = \"Processing Stage\"\nframe.use_custom_color = True\nframe.color = (0.2, 0.4, 0.6)\n\n# Parent nodes to frame\nnode_a.parent = frame\nnode_b.parent = frame\n\n# Mute a node (bypass it)\nnode_b.mute = True\n\n# Hide a node (collapse)\nnode_b.hide = True\n```\n\n---\n\n## Version Migration Matrix\n\n| Feature | Blender 3.x | Blender 4.0+ | Blender 5.0+ |\n|---------|-------------|--------------|---------------|\n| Group socket creation | `group.inputs.new()` \u002F `group.outputs.new()` | `group.interface.new_socket()` | `group.interface.new_socket()` |\n| Interface panels | Not available | Not available | Available (added 4.1) |\n| Compositor tree access | `scene.node_tree` | `scene.node_tree` | `scene.compositing_node_group` |\n| `scene.use_nodes` (compositor) | Required | Required | Deprecated (always True) |\n| Mix node | `ShaderNodeMixRGB` | `ShaderNodeMix` (new) | `ShaderNodeMix` |\n| Shader name `3D_UNIFORM_COLOR` | Valid | Removed — use `UNIFORM_COLOR` | Use `UNIFORM_COLOR` |\n\n---\n\n## Reference Links\n\n- [references\u002Fmethods.md](references\u002Fmethods.md) — Complete API signatures for NodeTree, NodeTreeInterface, Node, NodeSocket, NodeLink\n- [references\u002Fexamples.md](references\u002Fexamples.md) — Working code examples for all node tree types\n- [references\u002Fanti-patterns.md](references\u002Fanti-patterns.md) — What NOT to do with node trees\n\n### Official Sources\n\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeTree.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeTreeInterface.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.Node.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeSocket.html\n- https:\u002F\u002Fdocs.blender.org\u002Fapi\u002Fcurrent\u002Fbpy.types.NodeLink.html\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F4.0\u002Fpython_api\u002F\n- https:\u002F\u002Fdeveloper.blender.org\u002Fdocs\u002Frelease_notes\u002F5.0\u002Fpython_api\u002F\n",{"name":5,"license":14,"metadata":23,"description":26,"compatibility":27},{"author":24,"version":25},"OpenAEC-Foundation","1.0","Use when building node trees via Python -- Geometry Nodes, Shader Nodes, or Compositor Nodes. Prevents the breaking change of using node.inputs\u002Foutputs by index instead of NodeTreeInterface (4.0+) for node group I\u002FO. Covers node creation, linking, group management, and the NodeTreeInterface API migration. Keywords: node tree, Geometry Nodes, Shader Nodes, Compositor, NodeTreeInterface, node_group, links, nodes.new, node sockets, procedural geometry, create nodes from Python, connect nodes, add node.\n","Designed for Claude Code. Requires Blender 3.x\u002F4.x\u002F5.x with Python.","main","9bb7acf0c2ec4f44373969cb14e55af3c9a8385f","plugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot","2026-11-09 13:26:47",{"source":8,"skillName":5,"commands":35,"prompt":45,"zipAvailable":46},[36,39,42],{"tool":37,"command":38},"npx","npx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-nodes",{"tool":40,"command":41},"bunx","bunx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-nodes",{"tool":43,"command":44},"pnpm","pnpm dlx skills add lagzgabrielmuller-dot\u002Fkit-ingenieria-3d --skill blender-syntax-nodes","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes\u002FSKILL.md",true,[48,54,58],{"path":49,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":52,"sourceHtmlUrl":53},"references\u002Fanti-patterns.md","REFERENCE","参考文档",13823,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes\u002Freferences\u002Fanti-patterns.md",{"path":55,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":56,"sourceHtmlUrl":57},"references\u002Fexamples.md",16835,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes\u002Freferences\u002Fexamples.md",{"path":59,"resourceType":50,"resourceTypeDesc":51,"sizeBytes":60,"sourceHtmlUrl":61},"references\u002Fmethods.md",13249,"https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fblender-bim-sverchok\u002Fskills\u002Fblender\u002Fsyntax\u002Fblender-syntax-nodes\u002Freferences\u002Fmethods.md",[63,71,78,85,92,99],{"skillNo":64,"name":65,"nameZh":6,"description":66,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":67,"sourceHtmlUrl":68,"categories":69,"keywords":70,"publishedAt":18},"01M7FBFSZ93YM463CGS91D0TZG","manimce-best-practices","Trigger when: (1) User mentions \"manim\" or \"Manim Community\" or \"ManimCE\", (2) Code contains `from manim import *`, (3) User runs `manim` CLI commands, (4) Working with Scene, MathTex, Create(), or ManimCE-specific classes.\n\nBest practices for Manim Community Edition - the community-maintained Python animation engine. Covers Scene structure, animations, LaTeX\u002FMathTex, 3D with ThreeDScene, camera control, styling, and CLI usage.\n\nNOT for ManimGL\u002F3b1b version (which uses `manimlib` imports and `manimgl` CLI).","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fmanim-animaciones\u002Fskills\u002Fmanimce-best-practices\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fmanim-animaciones\u002Fskills\u002Fmanimce-best-practices\u002FSKILL.md",[],[],{"skillNo":72,"name":73,"nameZh":6,"description":74,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":75,"categories":76,"keywords":77,"publishedAt":18},"01M7FB2K59HNNXS9WKHAMWHC3C","drawio","Create, edit, replicate, import, and export draw.io diagrams with an offline YAML-first workflow: architecture, network topologies, flowcharts, UML\u002FER, org charts, Mermaid\u002FCSV conversion, existing .drawio bundles, style presets, themes, and non-publication formula diagrams. For publication figures (paper, thesis, IEEE, camera-ready) use drawio-academic-skills instead.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fdiagramas-y-documentos\u002Fskills\u002Fdrawio\u002FSKILL.md",[],[],{"skillNo":79,"name":80,"nameZh":6,"description":81,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":82,"categories":83,"keywords":84,"publishedAt":18},"01M7FB2BWX7GWK9H2X8BGCYDDD","drawio-academic-skills","Publication-figure overlay for draw.io. Use instead of drawio whenever the diagram is for a paper, thesis, dissertation, journal, conference, IEEE\u002FACM submission, manuscript, camera-ready, Word\u002FLaTeX figure, or other publication. Applies venue, figure-type, color, caption\u002Flegend, formula, and paper-readability gates for architecture, workflow, roadmap, network-topology, and replicated paper figures.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fdiagramas-y-documentos\u002Fskills\u002Fdrawio-academic-skills\u002FSKILL.md",[],[],{"skillNo":86,"name":87,"nameZh":6,"description":88,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":89,"categories":90,"keywords":91,"publishedAt":18},"01M7FB22JESEAV8T15DJT3D444","uncertainty-and-units","Tracks physical units and propagates measurement uncertainty in scientific calculations using pint and uncertainties. Use for unit conversion and dimensional checking, GUM uncertainty budgets, Type A and Type B evaluation, coverage factors and expanded uncertainty, Monte Carlo propagation, significant-figure and plus-minus reporting, error propagation through curve fits, CODATA constants, auditing Python code for stripped units or broken uncertainty propagation, and order-of-magnitude plausibility checks using dimensionless groups (Reynolds, Peclet, Damkohler, Knudsen, Biot, Womersley), characteristic scales such as diffusion time or Debye length, and observed magnitude ranges. Trigger on \"is this number physically reasonable\", \"sanity check these units\", \"what regime is this flow in\", or a result that looks off by orders of magnitude.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Funcertainty-and-units\u002FSKILL.md",[],[],{"skillNo":93,"name":94,"nameZh":6,"description":95,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":96,"categories":97,"keywords":98,"publishedAt":18},"01M7FB1ANRSG28R335FDY9SA3R","statistical-analysis","Guided statistical analysis for research data - test selection, assumption checking, effect sizes, power analysis, Bayesian alternatives, and APA-formatted reporting. Use whenever a user wants to compare groups, test a hypothesis, analyze experimental or survey data, check statistical assumptions, compute required sample sizes, or write up results - even if they never name a specific test. Covers t-tests, ANOVA, chi-square, correlation, regression, non-parametric and Bayesian methods. For low-level model APIs, see the statsmodels and pymc skills.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Fstatistical-analysis\u002FSKILL.md",[],[],{"skillNo":100,"name":101,"nameZh":6,"description":102,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":103,"categories":104,"keywords":105,"publishedAt":18},"01M7FB15KRA9D7JCPH4P9T6XJY","simpy","Builds, inspects, tests, and analyzes bounded process-based discrete-event simulations with SimPy. Use for event scheduling, resource queues, interrupts, monitoring, independent replications, warm-up, and reproducible output analysis.","https:\u002F\u002Fgithub.com\u002Flagzgabrielmuller-dot\u002Fkit-ingenieria-3d\u002Fblob\u002Fmain\u002Fplugins\u002Fciencia-y-calculo\u002Fskills\u002Fsimpy\u002FSKILL.md",[],[]]