Skip to main content
skill CX Codex

geometry-nodes — Claude Code skill: procedural modeling

geometry-nodes — a skill for Claude Code and other platforms that automates procedural system creation in Blender. It enables asset generation and instancing pipelines via MCP.

MIT 640 installs ★ 4,589 updated 2026-11-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arjun988/blender-skills --skill geometry-nodes -a claude-code
Open on GitHub

What geometry-nodes does

This skill facilitates the development of reusable node groups for parametric modeling. It automates pipelines for scattering systems such as vegetation, cables, or modular structures, enabling non-destructive iteration across complex scenes.

The system utilizes standardized node groups labeled with the GN_ prefix. Users define parameters like density and scale to control asset generation. The tool supports export integration, requiring instances to be realized before export unless the target engine supports native instancing.

Blender must be installed on your machine to perform these tasks. Performance issues may occur if you attempt to scatter objects without a proper level of detail or culling plan.

What it helps with

  • automate surface scatter systems
  • generate parametric buildings and infrastructure
  • create procedural vegetation clusters
  • prepare procedural assets for engine export

Example prompts for the agent

  • Create a scatter system using geometry-nodes
  • Generate a parametric GN_Wall_Variant with custom inputs
  • Validate polygon counts for GN_Vegetation_Cluster before export

How to install geometry-nodes

1Skills CLI (Vercel)

npx skills add arjun988/blender-skills --skill geometry-nodes -a claude-code

2Manually: put the files in place

~/.claude/skills/geometry-nodes/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/geometry-nodes/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about geometry-nodes

How to install geometry-nodes in Claude Code?

Run the command npx skills add arjun988/blender-skills --skill geometry-nodes -a claude-code in your project terminal.

What does geometry-nodes do?

It helps an AI agent manage procedural Blender systems, create node groups, and automate the generation of parametric assets.

What is required to use geometry-nodes?

You must have Blender installed on your system to process the 3D geometry.

Source text

SKILL.md · MIT
---
name: geometry-nodes
description: Blender Geometry Nodes for procedural modeling, scatter systems, vegetation, buildings, pipes, cables, and reusable node groups. Use for procedural asset generation and instancing pipelines via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: geometry nodes, procedural, scatter, node group, GN_, instancing, parametric
  related-skills: procedural-modeling, environment-artist, blender-modeler
---

# Geometry Nodes

Reusable procedural systems. Parametric assets. Performance-aware instancing.

## When to Use

- Scatter systems (rocks, vegetation, debris)
- Parametric buildings, roads, pipes, cables
- Procedural variation without unique modeling
- Kit assembly with randomization
- Non-destructive iteration on large scenes

## Workflow

```
Define Parameters → Build Node Tree → Create Node Group (GN_)
    → Test Variations → Bake/Instance Decision → Export Integration
```

## Node Group Standards

- Prefix: `GN_[System]_[Descriptor]`
- Expose only necessary inputs (seed, density, scale range)
- Document input ranges in group name or custom properties
- Version node groups: `GN_Scatter_Rocks_v02`

## Core Patterns

### Scatter System
```
Mesh Surface → Distribute Points on Faces → Instance on Points
    → Randomize Rotation (Z) → Randomize Scale → Realize (optional)
```

### Building Generator
```
Floor Count (input) → Repeat Mesh → Stack Instances
    → Window Cut Pattern → Material Variation → Output
```

### Cable/Pipe Routing
```
Curve Input → Curve to Mesh (profile) → Subdivide → Set Material
    → Multiple curves from single path node
```

### Rock Formation
```
Ico Sphere → Displace (noise) → Decimate → Instance Scatter
```

## Randomization

| Parameter | Typical Range |
|-----------|---------------|
| Scale | 0.8–1.2 (uniform or per-axis) |
| Rotation Z | 0–360° |
| Density | 0.1–2.0 per m² |
| Seed | Integer for reproducibility |

Always expose seed as group input for art direction iteration.

## Performance Rules

| Scenario | Approach |
|----------|----------|
| Game export | Realize instances → decimate → export mesh |
| Background scatter | Keep instanced; limit count |
| Hero procedural | Bake to static mesh for engine |
| Viewport preview | Limit instance count attribute |

## Reusable Systems Library

| Group | Purpose |
|-------|---------|
| GN_Scatter_Objects | Generic surface scatter |
| GN_Array_Modular | Linear modular repetition |
| GN_Curve_Pipe | Pipe/cable along curve |
| GN_Wall_Variant | Parametric wall sections |
| GN_Vegetation_Cluster | Tree/bush clustering |

## MCP Integration

1. Create geometry nodes modifier via MCP
2. Configure group inputs via MCP
3. Query instance count and final polycount
4. Realize geometry for export via MCP
5. Organize GN objects in dedicated collection

## Integration with Export

Before export:
1. Apply geometry nodes modifier OR
2. Realize instances and merge OR
3. Export as instances if engine supports (Unreal HISM)

Document which approach per target engine.

## Constraints

### MUST DO
- Create reusable node groups, not one-off trees
- Expose seed and density as inputs
- Test at min/max parameter extremes
- Realize/bake before game export unless engine supports instances
- Name groups with `GN_` prefix

### MUST NOT DO
- Million-instance scatter without LOD/culling plan
- Nested realize operations (performance killer)
- Hardcode values that should be inputs
- Export procedural without polycount validation
- Skip variation testing at boundary values

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Scatter recipes | `references/scatter-systems.md` | Environment scatter |
| Building generators | `references/building-generators.md` | Architectural procedural |

© https://github.com/arjun988 · MIT · arjun988/blender-skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →
scenario-blender-geometry-nodes scenario-labs scenario-blender-geometry-nodes is a skill that builds and debugs Blender Geometry Nodes via Python for procedural modeling, simulations, and 5.2 physics. CX Codex +1 969installs procedural-blender-nodes gokayfem procedural-blender-nodes is a Claude Code skill that builds procedural Blender node trees from Python. Runs when generating Geometry Nodes assets, shader setups, and simulation zones. CX Codex +1 ★ 101repo stars blender-nodes gokayfem 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+. CX Codex +1 ★ 101repo stars blender-geometry-nodes blender-agent-skills The blender-geometry-nodes Claude Code skill helps build Geometry Nodes setups in Blender. It comes into play for procedural assets, surface scattering, and modifier inputs. CX Codex +1 563installs scenario-blender-hard-surface scenario-labs scenario-blender-hard-surface is a Claude Code skill for Blender hard-surface modeling with boolean cuts, bevels, weighted normals and subdivision. It addresses broken shading and bevels that vanish after a boolean. CX Codex +1 1,000installs blender-sculpting blender-agent-skills blender-sculpting — a skill for Claude Code runs procedural sculpting workflows in Blender 5.3 for organic models and characters. Used when building base meshes, adding surface details, and preparing bake sources. CX Codex +1 558installs

From the same set57

The whole set →
export-pipeline export-pipeline — a skill that automates 3D asset exports from Blender to game engines. Validates mesh parameters to ensure engine-ready output. CX Codex +1 664installs lowpoly-style The lowpoly-style Claude Code skill guides low-poly art direction in Blender. It activates for retro game visuals built from simple shapes and atmospheric lighting. CX Codex +1 662installs prop-artist prop-artist — a skill for Claude Code, Codex, and others that models grounded, readable props and furniture. The agent manages scale, silhouettes, and detail tiers based on real-world reference logic. CX Codex +1 656installs camera-cinematography The camera-cinematography skill for Claude Code manages camera framing, lens selection, and movement animation in Blender. It runs when setting up cinematic sequences or planning shot layouts. CX Codex +1 653installs lighting Configures cinematic and game lighting in Blender via MCP. Sets up three-point rigs, HDRI maps, volumetrics, and mood lighting. CX Codex +1 636installs hard-surface A Claude Code skill guides Blender hard-surface modeling through MCP, from primary forms to panel details. It activates for sci-fi, vehicles, weapons, robotics, and mechanical props. CX Codex +1 630installs procedural-modeling The procedural-modeling skill for Claude Code manages procedural 3D asset generation in Blender via MCP. It configures Geometry Nodes setups for rocks, buildings, roads, and cables, preparing meshes for game export. CX Codex +1 622installs archviz archviz — a skill for Claude Code and Codex guides architectural visualization in Blender over MCP. Enforces real-world dimensions, camera framing, realistic materials, and final rendering. CX Codex +1 619installs

Project sponsors

Companies that keep this analytics open