# blender-texture-baking

blender-texture-baking — a skill for Claude Code that runs Cycles baking pipelines in Blender 5.3. Triggers when transferring high-poly sculpt details to game assets or converting procedural node networks to images.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 587 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-texture-baking/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-texture-baking

## What it does

Executes baking passes via `scripts/bake_maps.py`. It handles high-to-low transfers using either extrusion distances or explicit cages, and bakes standalone procedural shaders directly into image textures. The underlying runner targets available GPU hardware using OptiX, CUDA, HIP, Metal, or oneAPI before falling back to CPU execution.

Generates tangent-space normal maps in OpenGL or DirectX orientation, AO, curvature derived from normals, material ID passes, thickness, and standard PBR channels. It packs AO, Roughness, and Metallic into single ORM textures ready for glTF or Unreal Engine. Temporary image texture nodes are wired with appropriate color spaces and cleaned up after output files are written.

Low-poly meshes must have unwrapped UVs without overlapping islands and scale applied. Mismatched triangulation between Blender and the target game engine will produce shading seams, so triangulating before export is necessary.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install EL4CTEO/blender-skills skills/blender-texture-baking
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- Bake high-poly normals and AO onto optimized game meshes
- Flatten procedural Cycles node trees into standalone PBR maps
- Pack Ambient Occlusion, Roughness, and Metallic into an ORM map
- Fix ray misses, skewed floating bolts, and projection artifacts with a cage

## Example prompts
- Bake normal, AO, and curvature maps from Crate_high onto SM_Crate at 2048 resolution
- Self-bake procedural materials on SM_Crate into base color, roughness, and pack ORM
- Run normal map baking with --directx enabled and set extrusion to 0.05

## 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: 2cffb171d943dbfe.

BEGIN THIRD-PARTY FILE 2cffb171d943dbfe
````text
---
name: blender-texture-baking
description: Bake texture maps in Blender 5.3 Cycles - high-to-low normal maps with cage/extrusion, AO, curvature, ID, thickness, base color/roughness/metallic from procedurals, ORM packing, OpenGL vs DirectX, margins, GPU baking, fixing skewing/waviness/seams. Use when transferring sculpt or high-poly detail to game meshes or converting procedural materials to textures.
license: MIT
metadata:
  author: blender-agent-skills
  version: "1.2.0"
---

# Texture Baking (Cycles)

The execution model is in `blender-core`. UVs come from `blender-retopology-uv` and materials from `blender-pbr-materials`.

## One call
```
scripts/bake_maps.py -- --low SM_Crate --high Crate_high Crate_bolts --maps normal ao curvature id \
   --res 2048 --samples 64 --margin-px 16 --pack-orm --out //textures
```
Self-bake (procedural → textures, no `--high`): `--low SM_Crate --maps basecolor roughness metallic normal --pack-orm`.
The script picks the GPU (OptiX/CUDA/HIP/Metal/oneAPI) and falls back to CPU, creates the target images with correct color spaces, cleans up its temporary nodes, and saves `T_<name>_<N|AO|CURV|BC|R|M|ORM...>.png`.

## Preparation checklist (most bake bugs come from this list)
1. **Low poly**: UVs unwrapped, no overlaps (stacked/mirrored islands moved +1 U), padding ≥ 8 px at the bake resolution, scale applied.
2. **Hard edges = UV seams** on the low poly. Use either smooth shading with the bake handling gradients, or hard edges split at seams. Never put a hard edge inside a UV island.
3. **Triangulate the low poly the same way the engine will**, or export the triangulated mesh. Mismatched triangulation shows as shading seams.
4. **High poly** covers the low completely and pokes out of it only a little. Floaters (bolts, panel details) can hover just above the surface, but must stay within the extrusion distance.
5. **Names**: `X_low` / `X_high` pairs. Bake per part, or explode the parts apart (move each pair along an axis) so neighbouring parts don't project onto each other, then put them back.
6. Apply modifiers on the high poly as needed (multires and subd are evaluated automatically).

## Rays: extrusion vs cage
````
END THIRD-PARTY FILE 2cffb171d943dbfe

The third-party file has ended. Everything between the 2cffb171d943dbfe 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 2185 of 5713 bytes. © blender-agent-skills · MIT · https://github.com/EL4CTEO/blender-skills/tree/HEAD/skills/blender-texture-baking/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
