# uv-workflow

uv-workflow — a skill that automates UV unwrapping in Blender via MCP. Runs when preparing meshes for texturing and game engine export.

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

## What it does

This skill generates efficient UV layouts with consistent texel density. It manages seam placement, island packing, UDIM setup, and lightmap UV channel generation.

The agent executes scripts to mark seams, perform unwrapping, and validate UV islands. It checks for overlapping geometry and packing efficiency based on target resolution. Ensure the Blender environment is configured for MCP access before running the skill.

## Requirements
- Works with: Blender

## Install

### Claude Code (native platform)

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

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

### Codex

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

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

### Cursor

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

2. **Manually: put the files in place**
- File: `.cursor/skills/uv-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/uv-workflow
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

## When to use it
- hide seams in non-visible areas
- standardize texel density across parts
- configure UDIM tiles for high-detail assets
- generate secondary UV channels for baked lighting
- pack UV islands with correct bleeding margins

## Example prompts
- Use `uv-workflow` to automate seam marking on the selected mesh
- Check texel density consistency with `uv-workflow`
- Validate the UV layout using `uv-workflow` before exporting

## 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: 12f76b150d957dad.

BEGIN THIRD-PARTY FILE 12f76b150d957dad
````text
---
name: uv-workflow
description: Production UV unwrapping for seam placement, UV packing, texel density, UDIM, lightmap UVs, and modular UV layouts. Use when preparing meshes for texturing and engine export in Blender via MCP.
license: MIT
metadata:
  author: https://github.com/arjun988
  version: "1.0.0"
  domain: blender
  role: specialist
  triggers: UV, unwrap, seam, texel density, UV pack, UDIM, lightmap UV, UV layout
  related-skills: texture-workflow, materials, export-pipeline
---

# UV Workflow

Efficient UV layouts with consistent texel density. Seams at hidden edges. Engine-ready.

## When to Use

- After topology locked, before texturing
- Modular kit UV atlas planning
- Lightmap UV channel setup
- UDIM workflows for hero assets

## Workflow

```
UV Planning → Seam Marking → Unwrap → Texel Density Check
    → Pack → Mirror/Overlap Decision → Lightmap UV (if needed) → Validation
```

## Seam Placement Rules

Place seams at:
- Back of head, spine centerline
- Inner arms, inner legs
- Bottom of chin, underside of objects
- Panel edges on hard surface (construction seams)
- Hidden areas under clothing/overlaps

Never place seams on:
- Face (front)
- Primary gameplay-visible surfaces
- Deforming joint centers (relocate to nearby hidden area)

## Texel Density

**Formula:** `Texel Density = Texture Resolution / UV Island Size in UV space`

Target consistency across visible surfaces:

| Asset Tier | Target TD (px/m) |
|------------|------------------|
| Hero | 512–1024 px/m |
| Standard | 256–512 px/m |
| Background | 128–256 px/m |

Use same density for modular kit pieces sharing atlas.

## Unwrap Methods

| Method | Use When |
|--------|----------|
| Smart UV Project | Quick blockout UVs only |
| Follow Active Quads | Strip UVs (roads, limbs) |
| Cube Project | Boxy hard surface |
| Lightmap Pack | Lightmap channel |
| Manual seam + Unwrap | Production default |

## UV Packing

- Margin: 0.002–0.01 UV units (engine dependent)
- Rotate islands for maximum packing efficiency
- Group islands by material ID
- Keep related islands near each other in UV space
- Use UVPackmaster or native pack for production

## Mirrored UVs

- Mirror UVs for symmetrical characters (save texture space)
- Offset mirrored islands slightly if engine requires unique bakes
- Mark mirrored halves in object naming: `_L` / `_R` meshes if separate

## UDIM Workflow

For hero assets exceeding single 4K texture:
- Tile 1001: head
- Tile 1002: torso
- Tile 1003: limbs
- Document tile assignment in production brief

## Lightmap UVs

Second UV channel requirements:
- No overlapping islands
- Consistent texel density less critical
- Larger margin (0.02+) for light bleed prevention
- Pack separately from texture UVs

## Modular UV Atlas

```
1. Plan shared atlas resolution (2048/4096)
2. Assign UV islands per module to atlas regions
3. Trim sheet regions for repeating detail
4. Vertex color variation for module differentiation
5. Document atlas layout for texture artist
```

## MCP Integration

1. Mark seams via MCP if supported
2. Execute unwrap via MCP
3. Query UV island count and pack efficiency
4. Assign UV channels via MCP
````
END THIRD-PARTY FILE 12f76b150d957dad

The third-party file has ended. Everything between the 12f76b150d957dad 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 3176 of 4240 bytes. © https://github.com/arjun988 · MIT · https://github.com/arjun988/blender-skills/tree/HEAD/.claude/skills/uv-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
