Skip to main content
skill CX Codex

uv-workflow — Claude Code skill: what it does, how to install

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

MIT 672 installs ★ 4,589 updated 2026-11-06

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add arjun988/blender-skills --skill uv-workflow -a claude-code
Open on GitHub

What uv-workflow 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.

What it helps with

  • 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 for the agent

  • 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

How to install uv-workflow

1Skills CLI (Vercel)

npx skills add arjun988/blender-skills --skill uv-workflow -a claude-code

2Manually: put the files in place

~/.claude/skills/uv-workflow/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/uv-workflow/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about uv-workflow

How to install uv-workflow in Claude Code?

Run npx skills add arjun988/blender-skills --skill uv-workflow -a claude-code in your terminal.

What does uv-workflow do?

It automates UV unwrapping tasks such as marking seams, packing islands, calculating texel density, and setting up lightmap channels in Blender.

What is required to use uv-workflow?

You need Blender installed and configured with MCP support.

Source text

SKILL.md · MIT
---
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
5. Validate no overlapping UVs (except intentional mirror)

## Validation Checklist

- [ ] No unintended overlapping UVs
- [ ] Consistent texel density on visible surfaces
- [ ] Seams hidden at gameplay angles
- [ ] UV islands within 0–1 (or UDIM tiles assigned)
- [ ] Lightmap channel separate if required
- [ ] Pack efficiency > 75%

## Constraints

### MUST DO
- Plan UVs before final modeling (topology informed by UV needs)
- Maintain texel density consistency
- Hide seams at logical construction edges
- Create lightmap UVs for baked lighting pipelines
- Document atlas layout for modular kits

### MUST NOT DO
- Smart UV Project as final production UVs
- Overlapping UVs on unique surface detail (unless mirrored)
- Inconsistent texel density on same asset tier
- Seams across faces or primary visible surfaces
- Skip packing margins

## Reference Guide

| Topic | Reference | Load When |
|-------|-----------|-----------|
| Texel density calc | `references/texel-density.md` | Hero assets |
| Trim sheets | `references/trim-sheets.md` | Modular kits |

© https://github.com/arjun988 · MIT · arjun988/blender-skills

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set57

The whole set →
asset-optimization The asset-optimization Claude Code skill checks and optimizes Blender 3D assets before export using MCP scene queries. Runs geometry audits, cleans topology, generates LOD meshes, and writes validation reports. CX Codex +1 720installs materials The materials skill automates PBR and stylized material creation in Blender via MCP. It is triggered during look development, procedural shader design, and production asset preparation. CX Codex +1 708installs environment-artist The environment-artist Claude Code skill guides game environment work in Blender, from modular buildings and terrain to vegetation and scene composition. It applies to architecture, interiors, exteriors, and level art. CX Codex +1 697installs animation This skill automates game-ready animation workflows in Blender. It activates when defining keyframes for characters or mechanical objects. CX Codex +1 675installs qa-review qa-review — a skill for Claude Code reviews Blender assets with viewport screenshots, checklists, and naming audits. It runs before export or handoff and after major modeling or lookdev milestones. CX Codex +1 672installs 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. CX Codex +1 667installs retopology retopology — a skill for creating production-ready, quad-dominant meshes in Blender. It initializes during mesh processing after high-poly sculpting or scanning. CX Codex +1 667installs export-pipeline export-pipeline — a skill that automates 3D asset exports from Blender to game engines. Validates mesh parameters to ensure engine-ready output. CX Codex +1 664installs

Project sponsors

Companies that keep this analytics open