Video to Blender plugin
Agent skill for Blender: builds a procedural node system from a video, image or idea and checks the finished graph.
- 95 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The agent runs Python in Blender and writes .blend files and project scripts.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/video-to-blenderDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The agent runs Python in Blender and writes .blend files and project scripts.
This is third-party code. Review the repository files before installing.
What it does
Video to Blender teaches an agent to build editable procedural node systems in Blender: Geometry Nodes, Shader Nodes and a compositor graph. The graph is built by the Python library nodekit: sockets are found by name, blocks are framed with a sentence, layout is automatic and the result is read back as JSON and linted. A tested library of 39 NK groups in six modules sits beside it, each group built and numerically checked in Blender. Validation has two steps: `nodes_tools.py check` builds and evaluates every group with zero warnings, while `validate.py` reopens a saved .blend and checks warnings, evaluation time and camera clearance. The Storybook Street example recreates a 20-second village clip as one Geometry Nodes modifier on a curve.
Who it is for. 3D artists and technical artists who trust an agent with Blender graphs and want an editable result.
Good fit when
- You need to recreate a scene from a reference clip as a parametric scene.
- An agent breaks a shared node group on rebuild and links fall off.
- A complex graph grew into one 300-node group with no frames or descriptions.
- The same procedural scene has to run on a different input curve.
Not a fit when
- You need one static model where a procedural graph is overkill.
- Your Blender is older than 5.2.
- You just need a render with no editable structure.
Example request
Build a procedural Geometry Nodes scene from this reference clip, add an artist control panel and check the graph with the validator.Limitations
Blender 5.2 or newer is required. The nodekit library and validation scripts run inside Blender, while the skill works with saved project files. Reconstruction from a reference clip is a single optional prompt, and accuracy depends on the agent model. Every visible part of the Storybook Street scene is a node graph, and Python only builds these graphs and sets the input curve, sun, camera and render settings. Adapters for ChatGPT, Gemini Gems and other chats sit in the adapters folder and have no way to run Blender.
How to disable. Remove the plugin with `claude plugin uninstall video-to-blender@video-to-blender` or the `~/.claude/skills/procedural-blender-nodes` skill folder. .blend files stay in the project.
FAQ
Why is nodekit needed?
Agents write Blender scripts blind: they cannot see the graph or the render, and the Python API changed in 5.x. nodekit builds the graph by socket names, lays it out automatically and reads the result back as JSON.
How do I check a finished graph?
`nodes_tools.py check` builds and evaluates every group with zero warnings and zero lint. `validate.py` reopens a saved .blend and checks warnings, evaluation time and camera clearance.
Which agents are supported?
Claude Code installs as a plugin. Codex, Cursor, Gemini CLI and Copilot connect through `npx skills` or by hand, with rule adapters for Cursor and Copilot.
Do I need a reference image or video?
No. Reference-driven reconstruction is one optional prompt, and a procedural scene can start from an idea.
What is the Storybook Street example?
A village scene along a path: a cobbled road, half-timbered houses, props, bunting in the wind and a walker with planted feet. One curve defines the whole street, and a different curve builds a different street.
Discussion
No questions or reviews yet.
Related
PluginsBlender Agent Studio builds models and scenes in Blender from a description: a .blend file, Python source and checked renders.
A skill collection guides AI agents through Blender modeling, materials, animation and asset checks using supplied Python scripts.
A workflow for short AI videos: nine flows, agent roles, skills and Python tools for pixel animation.
A skill that guides an agent from a Gaussian splat to a Blender scene on Geometry Nodes and Shader Nodes, checked on views.
A loop skill: the agent generates a target screenshot, builds toward it, and uses a critic subagent to close the gap until they match
A skill that turns your narration and real assets into a 20–60 second video in the style you pick, rendered locally as MP4.
README in short
The skill pairs a workflow with the nodekit library and tested node groups. The workflow has a definition of done: an artist macro panel, presets, sweeps, reuse, animation checks and honest reporting.