# geometry-nodes

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 640 installs · ★ 4589 repo stars
- Author: https://github.com/arjun988
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/geometry-nodes/SKILL.md
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/geometry-nodes

## What it 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.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill geometry-nodes -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/geometry-nodes/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/geometry-nodes/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill geometry-nodes -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/geometry-nodes/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill geometry-nodes -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/geometry-nodes/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install arjun988/blender-skills .claude/skills/geometry-nodes
```

2. **Manually: put the files in place**
- File: `.github/skills/geometry-nodes/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill geometry-nodes -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/geometry-nodes
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/geometry-nodes/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add arjun988/blender-skills --skill geometry-nodes -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/geometry-nodes/SKILL.md

## When to use it
- automate surface scatter systems
- generate parametric buildings and infrastructure
- create procedural vegetation clusters
- prepare procedural assets for engine export

## Example prompts
- 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

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: f5a93a7cd094c527.

BEGIN THIRD-PARTY FILE f5a93a7cd094c527
````text
---
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
````
END THIRD-PARTY FILE f5a93a7cd094c527

The third-party file has ended. Everything between the f5a93a7cd094c527 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2849 of 3905 bytes. © https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/geometry-nodes/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
