Skip to main content
rule CX Codex

blender-nodes — Claude Code rule: what it does, how to install

blender-nodes is a Claude Code rule for writing Python scripts that generate Blender node setups with bpy. It guides agents working on procedural node trees for Blender 5.2+.

MIT ★ 101 updated 2026-10-21

Install into GitHub Copilot · Manually: put the files in place All methods and platforms ↓
.github/instructions/blender-nodes.instructions.md
Open on GitHub

What blender-nodes does

The rule instructs coding agents to construct Blender node trees using nodekit's Graph helper and pre-built NK library groups. It applies specifically to **/*.py files containing bpy code.

Direct assignment to modifier ID properties such as mod["Socket_2"] is blocked. Code must use nodekit.inspect.set_modifier_inputs instead. Animated node groups accept a Time input in seconds, while per-instance variation relies on nk_color and nk_rand attributes.

Shared groups must be built only once because regenerating a group wipes its interface and breaks all links. Work is verified headlessly by executing blender -b --factory-startup --python build.py followed by scripts/validate.py.

What it helps with

  • construct procedural node trees for Blender 5.2+ using nodekit
  • assign modifier socket values through set_modifier_inputs without ID properties
  • configure inputs into panels with explicit descriptions and ranges
  • validate generated .blend files with scripts/validate.py

Example prompts for the agent

  • Generate a procedural geometry node setup using nodekit and NK library groups
  • Set modifier inputs via nodekit.inspect.set_modifier_inputs for build.py
  • Run the validation test with scripts/validate.py against the generated blend file

How to install blender-nodes

Manually: put the files in place

.github/instructions/blender-nodes.instructions.md

The applyTo field sets which files it applies to

Step by step, with commands for each platform: AGENTS.md vs CLAUDE.md: what they are and which one to use

Questions about blender-nodes

How to install blender-nodes in Claude Code?

Run /plugin marketplace add gokayfem/video-to-blender followed by /plugin install video-to-blender@video-to-blender. You can also place the rule directly in .claude/rules/blender-nodes.md.

What does the blender-nodes rule do?

It enforces conventions for building Blender node systems in Python, covering nodekit graphs, group reuse, animation timing, and headless validation.

What is required to use blender-nodes?

It requires Blender 5.2+, the procedural-blender-nodes skill installed with gh skill install gokayfem/video-to-blender procedural-blender-nodes, and the scripts/validate.py script.

Source text

blender-nodes.instructions.md · MIT
---
applyTo: "**/*.py"
---

Copy this file into your repository's `.github/instructions/`. It applies to Python files that use `bpy` to build
Blender node systems; ignore it for other Python. For agent mode, also install the skill with
`gh skill install gokayfem/video-to-blender procedural-blender-nodes`.

- Build node trees from Python for Blender 5.2+ with nodekit's `Graph` (from the `procedural-blender-nodes` skill),
  and instance the tested `NK` library groups instead of hand-writing copies.
- Give every group and input a description, inputs ranges and subtypes, put them in panels (Primary first), and
  frame each block with a sentence.
- Animated groups take a `Time` input in seconds; only the top-level modifier group reads Scene Time. Per-piece
  variation goes to materials through `nk_color` and `nk_rand` attributes.
- Build shared groups once; rebuilding one clears its interface and unlinks every user.
- Never set modifier inputs as ID properties (`mod["Socket_2"]`); use
  `nodekit.inspect.set_modifier_inputs(mod, {"Name": value})` (`mod.properties.inputs.<identifier>.value`).
- Run Blender as `blender -b --factory-startup --python build.py`, then validate the saved .blend with
  `scripts/validate.py`: zero node warnings, zero lint.

© gokayfem · MIT · gokayfem/video-to-blender

Similar IDE rules

All IDE rules for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set5

Project sponsors

Companies that keep this analytics open