Skip to content
Back to search

video-to-blender

MarketplaceWorks with Claude CodeGitHub

Turn videos, images or ideas into procedural Blender node systems with coding agents

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/gokayfem--video-to-blender/badge.svg)](/listings/gokayfem--video-to-blender)

HTML

<a href="/listings/gokayfem--video-to-blender"><img src="/api/listings/gokayfem--video-to-blender/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Claude Code** (plugin marketplace):

claude plugin marketplace add gokayfem/video-to-blender
claude plugin install video-to-blender@video-to-blender

Or copy the skill: `cp -R skills/procedural-blender-nodes ~/.claude/skills/`.

**Codex, Cursor, Gemini CLI, Copilot and other agents** (via [skills](https://github.com/vercel-labs/skills)):

npx skills add gokayfem/video-to-blender

Or install by hand:

- **Codex:** copy `skills/procedural-blender-nodes` to `~/.agents/skills/`. - **Cursor:** copy it to `~/.cursor/skills/`, plus the rule in `adapters/cursor/`. - **Copilot:** `gh skill install gokayfem/video-to-blender procedural-blender-nodes`, plus `adapters/copilot/`. - **Gemini CLI:** `gemini extensions install https://github.com/gokayfem/video-to-blender`.

**claude.ai:** zip `skills/procedural-blender-nodes` and upload it under Settings > Capabilities > Skills.

**ChatGPT, Gemini Gems and other chat tools:** see [`adapters/`](adapters/).

You also need Blender 5.2 or later, as `blender` on PATH, `$BLENDER`, or the macOS app.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 23 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "video-to-blender",
  3. "description": "Turn videos, images or ideas into procedural Blender node systems with coding agents",
  4. "owner": {
  5. "name": "gokayfem",
  6. "url": "https://github.com/gokayfem"
  7. },
  8. "plugins": [
  9. {
  10. "name": "video-to-blender",
  11. "source": "./",
  12. "description": "Editable Geometry/Shader/compositor node systems built from Python, from a reference or from scratch, with a tested node-group library",
  13. "category": "development",
  14. "tags": [
  15. "blender",
  16. "geometry-nodes",
  17. "shader-nodes",
  18. "procedural",
  19. "bpy"
  20. ]
  21. }
  22. ]
  23. }
README.md · README · 181 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Video to Blender
  2. **Turn a reference video, image or idea into an editable procedural Blender node system.** A skill for coding
  3. agents (Claude Code, Codex, Cursor, Copilot, Gemini) that builds native Geometry Nodes, Shader Nodes and compositor
  4. graphs from Python, with a tested node-group library and validation tools.
  5. <p align="center"><img src="gallery/storybook/render.jpg" width="100%" alt="Storybook Street: a frame rendered from the node graphs"></p>
  6. <p align="center"><img src="gallery/storybook/blender.jpg" width="100%" alt="The same scene inside Blender: viewport, shader nodes, geometry nodes and the modifier controls"></p>
  7. | The top-level graph: one modifier builds the whole street | One part opened: the houses, framed block by block |
  8. |---|---|
  9. | ![Storybook Street top-level graph](gallery/storybook/graph_Storybook_Street.jpg) | ![Houses graph](gallery/storybook/graph_SS_Facades.jpg) |
  10. **Storybook Street** ([`prompts/storybook-street/`](prompts/storybook-street/)) rebuilds a 20 s AI-generated village
  11. clip as one Geometry Nodes modifier on a path curve: the cobbled road, half-timbered houses, props, bunting moving
  12. in the wind, and a walker with planted feet. A camera follows the walker on any path. Every visible part is a node
  13. graph: geometry and motion in Geometry Nodes, materials in Shader Nodes, the sky in the world shader, haze and glow
  14. in the compositor. Python only builds those graphs and sets up the input curve, sun, camera rig and render
  15. settings. Draw a different curve and the same graph builds a different street.
  16. The skill pairs a workflow with **nodekit**, a Python graph builder and inspector, and a **tested node-group
  17. library**: 39 `NK` groups in 6 modules, each built, evaluated and numerically checked in Blender. Blender 5.2 or
  18. later is required.
  19. ## Why
  20. Agents writing Blender node scripts work blind: they cannot see the graph or the render, Blender's Python API
  21. changed in 5.x, and a script that runs can still leave a broken or unreadable graph. Common results:
  22. - modifier inputs set as ID properties, which raises in 5.2;
  23. - a shared node group rebuilt in place, silently unlinking every user;
  24. - sockets looked up by index, which breaks when a node's mode changes;
  25. - a single 300-node group with no frames or descriptions;
  26. - motion baked as keyframes where a function of time would do;
  27. - a "procedural" asset that only works on the one input it was built for.
  28. This skill closes those gaps:
  29. - **nodekit builds graphs from Python** the way you would write them by hand. Sockets are found by name, panels
  30. and ranges are declared, blocks are framed with a sentence, and the layout is automatic. It reads the result
  31. back as JSON, lints it, and sets modifier inputs the 5.2 way.
  32. - **Tested building blocks** you instance instead of re-deriving. Each is checked in Blender with numbers, for
  33. example:
  34. - the curve frame is orthonormal on hills;
  35. - a bend preserves centreline length;
  36. - parcel widths sum to the curve length;
  37. - scatter counts follow density;
  38. - a planted foot never slides;
  39. - spring gain matches the analytic formula;
  40. - premultiplied haze has no halos.
  41. - **A checker and a validator.** `nodes_tools.py check` builds and evaluates every group with zero warnings and
  42. zero lint. `validate.py` reopens a saved .blend and checks warnings, evaluation time and camera clearance.
  43. - **A workflow with a definition of done:** artist controls (a Primary panel of macros), presets, sweeps, reuse on
  44. other inputs, temporal checks for animation, and honest reporting.
  45. - **Reference-driven reconstruction** as one optional prompt
  46. ([`prompts/reference-to-nodes-prompt.md`](prompts/reference-to-nodes-prompt.md)), not a requirement.
  47. ## Install
  48. **Claude Code** (plugin marketplace):
  49. ```bash
  50. claude plugin marketplace add gokayfem/video-to-blender
  51. ```
  52. ```bash
  53. claude plugin install video-to-blender@video-to-blender
  54. ```
  55. Or copy the skill: `cp -R skills/procedural-blender-nodes ~/.claude/skills/`.
  56. **Codex, Cursor, Gemini CLI, Copilot and other agents** (via [skills](https://github.com/vercel-labs/skills)):
  57. ```bash
  58. npx skills add gokayfem/video-to-blender
  59. ```
  60. Or install by hand:
  61. - **Codex:** copy `skills/procedural-blender-nodes` to `~/.agents/skills/`.
  62. - **Cursor:** copy it to `~/.cursor/skills/`, plus the rule in `adapters/cursor/`.
  63. - **Copilot:** `gh skill install gokayfem/video-to-blender procedural-blender-nodes`, plus `adapters/copilot/`.
  64. - **Gemini CLI:** `gemini extensions install https://github.com/gokayfem/video-to-blender`.
  65. **claude.ai:** zip `skills/procedural-blender-nodes` and upload it under Settings > Capabilities > Skills.
  66. **ChatGPT, Gemini Gems and other chat tools:** see [`adapters/`](adapters/).
  67. You also need Blender 5.2 or later, as `blender` on PATH, `$BLENDER`, or the macOS app.
  68. ## Use
  69. Ask naturally, for example:
  70. - *"Make a Geometry Nodes fence that follows any curve, with controls for post spacing and lean."*
  71. - *"Ivy that grows over whatever mesh I give it."*
  72. - *"Recreate this clip as an editable Blender setup."*
  73. - *"Port my 4.2 node script to Blender 5.2."*
  74. The agent routes the request, finds groups, writes a build script that saves a .blend, and checks it:
  75. ```bash
  76. python3 scripts/nodes_tools.py search curve fence
  77. python3 scripts/nodes_tools.py try -- --module my_effect --root . --png out/try.png
  78. blender -b my_effect.blend --python scripts/validate.py
  79. ```
  80. What the commands do:
  81. - `search` ranks library groups by name, summary, tags and uses.
  82. - `try` builds one group on a test input, prints its node warnings and lint, and renders a still.
  83. - `validate` reopens the saved file and checks warnings, counts, evaluation time and camera clearance.
  84. ## What's in the library
  85. | Module | Groups |
  86. |---|---|
  87. | `curve` | `NK Curve Frame` (s, d, h to a level frame on any curve), `NK Curve Bend` (bend curve-space geometry onto a path), `NK Curve Samples`, `NK Curve Parcels` (random widths that sum exactly, with fan data for bends), `NK Curve Ribbon`, `NK Catenary Point` (sagging ropes and cables) |
  88. | `shapes` | `NK Rounded Box`, `NK Chamfer Box` / `NK Chamfer Boxes` (chamfer size independent of scale), `NK Rod`, `NK Ring`, `NK Profile Revolve` (pots, barrels, vases), `NK Leaf`, `NK Blossom`, `NK Foliage Mound`, `NK Grass Tuft`, `NK Facade Frame` (one placement frame per wall face), `NK Store Local Coords` (per-piece texture space) |
  89. | `scatter` | `NK Scatter On Surface` (density, Poisson distance, slope/attribute masks, alignment), `NK Scatter Along Curve`, `NK Clumps` |
  90. | `motion` | `NK Damped Spring`, `NK Gait Step` (integrated phase, planted feet), `NK Wind Gust`, `NK Pendulum Sway`, `NK Time Remap` (loop, ping-pong, ease), `NK Flicker` |
  91. | `materials` | shader groups: `NK Attribute Tint`, `NK Stucco`, `NK Wood Grain`, `NK Stone`, `NK Felt`, `NK Terracotta`, `NK Stripes`, `NK Glow Glass`, `NK Ground`, `NK Root Tip Gradient`, plus `make_material()` |
  92. | `post` | compositor groups: `NK Haze Over Sky` (mist haze on premultiplied geometry over a sky gradient), `NK Soft Glow` |
  93. The full catalog with inputs and uses is
  94. [`references/library-index.md`](skills/procedural-blender-nodes/references/library-index.md).
  95. ## Storybook Street in detail, and the templates
  96. The top of this page is [`prompts/storybook-street/`](prompts/storybook-street/). It was measured against the
  97. reference over time (colour, luma percentiles, image motion) and validated by reopening the file; its README
  98. reports the results and the remaining differences. It has a Primary panel of eight macro controls, six presets,
  99. and the same graph on an S-bend, a hill and a spiral town:
  100. | Reference (top) vs reconstruction (bottom) | Variations of one graph | The same graph on other curves |
  101. |---|---|---|
  102. | ![reference vs reconstruction](prompts/storybook-street/docs/media/reference_vs_reconstruction.jpg) | ![variations](prompts/storybook-street/docs/media/variations.jpg) | ![transfer](prompts/storybook-street/docs/media/transfer.jpg) |
  103. Its [workflow](prompts/storybook-street/docs/WORKFLOW.md) became the reusable
  104. [reference-to-nodes prompt](prompts/reference-to-nodes-prompt.md), for any reference: a video, images, or a
  105. written description.
  106. Smaller starting points, each built only from the library and run on more than one input, are in
  107. [`templates/`](skills/procedural-blender-nodes/templates/):
  108. | [![fence](gallery/thumb_curve_fence.jpg)](gallery/curve_fence.png) | [![bunting](gallery/thumb_wind_bunting.jpg)](gallery/wind_bunting.png) | [![scatter](gallery/thumb_surface_scatter.jpg)](gallery/surface_scatter.png) | [![house](gallery/thumb_parametric_house.jpg)](gallery/parametric_house.png) | [![growth](gallery/thumb_growth_sim.jpg)](gallery/growth_sim.png) |
  109. |---|---|---|---|---|
  110. | Fence along any curve | Bunting in the wind | Scatter by slope and height | House from a few controls | Growth over any mesh (simulation zone) |
  111. ## Verification
  112. | Check | Where | What it proves |
  113. |---|---|---|
  114. | Static rules | `nodes_tools.py check` | every library group is registered with a summary and uses, has an `NK` name, and follows module order; the index is current |
  115. | Build + lint + evaluate | `nodes_tools.py check` (in Blender) | every group builds, every group and input has a description, no dangling nodes or invalid links, zero node warnings on test inputs |
  116. | Property tests | `nodes_tools.py test` (`tests/test_*.py`) | 59 numeric tests: curve frames orthonormal on hills, bends preserving centreline length, parcel widths summing to the curve length, sample counts on open and closed curves, scatter density and spacing, warning-free empty scatters, spring gain and phase against the formula, zero foot slide, bounded wind, exact loops, material renders, premultiplied haze, and a simulation front that is monotonic and frame-rate independent |
  117. | Templates | `tests/build_gallery.py` | every template builds, reopens with zero warnings and lint, and renders its gallery image |
  118. | Skill effect | `evals/` (`claude plugin eval`, paid, manual) | output-rule adherence with the skill vs without it on 6 Blender tasks, and no false triggers on 3 near-miss tasks; see [evals/README.md](evals/README.md) |
  119. CI (`.github/workflows/checks.yml`) downloads Blender 5.2.2 for Linux, checks its SHA-256, and runs the checks
  120. headless.
  121. ## Repository
  122. ```text
  123. skills/procedural-blender-nodes/ the skill: SKILL.md, nodekit/, library/, templates/, references/, scripts/
  124. tests/ property tests, Blender test runner, gallery builder, eval validator
  125. evals/ plugin eval suite: with vs without the skill
  126. gallery/ rendered templates
  127. prompts/ reference-to-nodes prompt and the Storybook Street project
  128. adapters/ prompts for tools without skill support
  129. .claude-plugin/ Claude Code plugin + marketplace manifests
  130. ```
  131. Contributing: see [AGENTS.md](AGENTS.md) for the rules every library change must pass. The sibling project for
  132. GLSL is [shader-skills](https://github.com/gokayfem/shader-skills).
  133. ## Credits and license
  134. MIT. All code is original. The techniques and sources are listed in [CREDITS.md](CREDITS.md).

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.