# blender-pbr-materials

blender-pbr-materials — a skill for Claude Code configures PBR materials and texture sets in Blender 5.3 following engine-ready rules.

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

## What it does

The skill enforces physically based material rules for Blender 5.3, covering Principled BSDF inputs, ORM channel packing, sRGB versus Non-Color spaces, and DirectX or OpenGL normal maps. The `scripts/build_pbr_material.py` script automates texture set assembly by filename, configures color spaces, and wires maps directly to target objects. Running the build scripts requires a functioning Python environment inside Blender.

The rules cover alpha modes, displacement, view transforms like AgX and Khronos PBR Neutral, and procedural baking for engines such as Unity, Unreal Engine, Godot, and Roblox. Proper setup prevents washed-out normals, incorrect roughness values, and common rendering artifacts.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install EL4CTEO/blender-skills skills/blender-pbr-materials
```

2. **Manually: put the files in place**
- File: `.github/skills/blender-pbr-materials/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/EL4CTEO/blender-skills --path skills/blender-pbr-materials
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add EL4CTEO/blender-skills --skill blender-pbr-materials -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/EL4CTEO/blender-skills/tree/HEAD/skills/blender-pbr-materials/SKILL.md

## When to use it
- assemble a PBR material from texture files via script
- configure correct color spaces for roughness and normal maps
- pack occlusion, roughness, and metalness into an ORM texture
- convert normal maps between DirectX and OpenGL formats
- set up dithered or blended alpha modes for foliage and glass

## Example prompts
- Build a PBR material for crate textures in //tex/crate applied to SM_Crate
- Configure the correct color spaces for roughness and normal maps in Blender
- Prepare ORM texture packing for glTF 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: 3ce02a14b152f40a.

BEGIN THIRD-PARTY FILE 3ce02a14b152f40a
```text
---
name: blender-pbr-materials
description: Physically based materials in Blender 5.3 - metal/roughness rules, Principled BSDF inputs, color spaces (sRGB vs Non-Color), measured albedo/F0 values, texture-set auto-wiring, ORM channel packing, DirectX vs OpenGL normals, alpha modes, displacement, view transforms (AgX, Khronos PBR Neutral), engine-ready material rules. Use when creating, fixing, or exporting materials and textures.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# PBR Materials

The execution model is in `blender-core`. Measured values are in [references/pbr-values.md](references/pbr-values.md).

## Fast paths
- Texture set → material: `scripts/build_pbr_material.py -- --name M_Crate --textures //tex/crate --objects SM_Crate`. It detects maps by filename (Poly Haven, ambientCG, Substance, UE suffixes), sets color spaces, splits ORM, flips DirectX normals, and routes AO to glTF.
- Solid physically-plausible material: `--preset gold|iron|plastic|rubber|wood|glass|skin|...` with an optional `--color R G B` (sRGB).

## The rules (violations are what make renders look "CG")
1. **Metallic is binary**: 0 (dielectric) or 1 (raw metal). Use in-between values only on transition pixels (dust or rust edges on metal). Painted metal counts as dielectric.
2. **Base color = albedo with no lighting**: no baked shadows/AO/highlights. Dielectric range is sRGB ~30–240 (linear 0.012–0.87): charcoal ≈ 50, fresh snow ≈ 240. Metals: base color = F0 reflectance, sRGB 180–255, never dark.
3. **Roughness carries the realism**. Break it up with grunge, smudges and wear. A constant roughness value looks fake; vary it ±0.1–0.2 across a surface.
4. **Color spaces**: Base Color and Emission use `sRGB`. Roughness, Metallic, Normal, AO, Height, Opacity and ORM use `Non-Color`. A wrong color space is the #1 bug (washed-out normals, wrong roughness).
5. **Specular**: leave `IOR` 1.5 and `Specular IOR Level` 0.5 for almost all dielectrics. Change IOR only for known materials (water 1.33, glass 1.5, diamond 2.42).
6. **Normal maps**: Blender, glTF, Unity and Roblox use **OpenGL** (Y+). Unreal and Substance's DirectX preset use **DirectX** (Y-), so flip G when converting. The bake and the target must use the same tangent basis (MikkTSpace) and the same triangulation.
7. **AO**: the Principled BSDF has no AO input. For engines, ship AO in the ORM red channel. For Cycles renders, don't multiply AO into base color, because the renderer computes occlusion.

## Principled BSDF (5.2) quick map
```
END THIRD-PARTY FILE 3ce02a14b152f40a

The third-party file has ended. Everything between the 3ce02a14b152f40a 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 2553 of 6126 bytes. © blender-agent-skills · MIT · https://github.com/EL4CTEO/blender-skills/tree/HEAD/skills/blender-pbr-materials/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
