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
.github/instructions/blender-nodes.instructions.mdWhat 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_inputswithout ID properties - configure inputs into panels with explicit descriptions and ranges
- validate generated
.blendfiles withscripts/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.mdThe applyTo field sets which files it applies to
1Plugin marketplace
/plugin marketplace add gokayfem/video-to-blender/plugin install video-to-blender@video-to-blender2Manually: put the files in place
.claude/rules/blender-nodes.mdThe paths frontmatter field limits the files: move applyTo from the source into paths
AGENTS.md
Codex reads AGENTS.md: paste the rule text there
Manually: put the files in place
.cursor/rules/blender-nodes.mdcFrontmatter: description, globs, alwaysApply. Move applyTo from the source into globs, or the rule will not attach on its own
Manually: put the files in place
.devin/rules/blender-nodes.mdManually: put the files in place
.clinerules/blender-nodes.mdStep 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