# texture-workflow

texture-workflow — a skill for Claude Code that orchestrates PBR map baking, atlas packing, and texture memory optimization in Blender via MCP. Executes during low-poly asset preparation for game engines.

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

## What it does

This skill guides baking from high-poly sculpts to low-poly geometry, generating normal, AO, and curvature maps. It configures bake cage extrusion between 0.01m and 0.05m and applies a minimum 16px bake margin to eliminate visible seam artifacts.

To cut down texture memory, the workflow packs AO, roughness, and metallic into a single linear ORM file for engines like Unreal. Base color maps stay strictly in sRGB space without embedded ambient occlusion, keeping shader lighting physically accurate.

Geometry setup, baking commands, and material slot assignments depend directly on Blender MCP tools. Without an active Blender MCP connection, the agent cannot query texture budgets or adjust bake passes automatically.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- bake high-poly sculpt details to normal and ambient occlusion maps
- pack AO, roughness, and metallic channels into a single ORM texture
- build shared texture atlases for modular environment kits
- project and blend mesh decals across surfaces

## Example prompts
- Bake normal and AO maps from high-poly mesh using cage extrusion
- Pack roughness, metallic, and AO into an ORM map for Unreal
- Set up a modular kit texture atlas in Blender via MCP

## 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: a56b8f183def2b95.

BEGIN THIRD-PARTY FILE a56b8f183def2b95
````text
---
name: texture-workflow
description: Production texture workflow for atlases, baking AO/curvature/normal/roughness maps, decals, and texture memory optimization. Use for game-ready texture pipelines in Blender via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: texture, bake, normal map, AO, curvature, roughness, metallic, height, atlas, decal, emission
  related-skills: uv-workflow, materials, asset-optimization
---

# Texture Workflow

Bake high-poly detail to efficient texture sets. Optimize memory. Engine-ready outputs.

## When to Use

- Baking sculpt detail to normal maps
- Creating texture atlases for modular kits
- PBR texture set generation
- Decal placement and blending
- Texture memory optimization

## Workflow

```
High/Low Poly Setup → Cage Setup → Bake Maps → Composite
    → Atlas Pack → Engine Format Export → Validation
```

## Standard PBR Texture Set

| Map | Format | Notes |
|-----|--------|-------|
| Base Color | sRGB PNG | No embedded AO |
| Normal | Linear PNG | OpenGL convention unless engine specifies |
| Roughness | Linear PNG | Single channel |
| Metallic | Linear PNG | Single channel |
| AO | Linear PNG | Multiply in shader, not base color |
| Height | Linear PNG | Optional parallax |
| Emission | sRGB PNG | Mask-based |
| ORM Packed | Linear PNG | R=AO, G=Roughness, B=Metallic (Unreal) |

Naming: `T_[Asset]_[Map]` per `../references/naming-conventions.md`

## Bake Setup

```
1. Low-poly mesh with UVs (active)
2. High-poly mesh (sculpt or detail) — selected
3. Cage extrusion: 0.01–0.05m (adjust per asset scale)
4. Ray distance: match cage
5. Bake margin: 16px minimum
6. Anti-aliasing: enabled
```

## Maps to Bake

| Map | Source | Priority |
|-----|--------|----------|
| Normal | High→Low | Required |
| AO | High or low (cavity) | Required |
| Curvature | High sculpt | Wear masks |
| Position | High | Optional (blending) |
| Thickness | Subsurface meshes | Characters |

## Texture Atlas Strategy

Modular kits share one atlas:
```
1. All modules UV'd to shared 0–1 or UDIM space
2. Bake each module to atlas regions
3. Trim sheet areas for repeating detail
4. Single material references atlas
5. Document region map for artists
```

## Decals

- Decal mesh projected on surface
- Separate UV channel or atlas region
- Blend via alpha mask
- Limit decal overdraw in engine

## Memory Optimization

| Technique | Savings |
|-----------|---------|
| ORM packing | 3 textures → 1 |
| Shared atlas | N materials → 1 texture |
| Lower res on hidden surfaces | 50%+ memory |
| BC compression in engine | 4:1 or 6:1 |
| Trim sheets | Reuse detail across assets |
````
END THIRD-PARTY FILE a56b8f183def2b95

The third-party file has ended. Everything between the a56b8f183def2b95 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 2727 of 4026 bytes. © https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/texture-workflow/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
