uv-workflow — скилл для Claude Code: что делает и как установить
Скилл uv-workflow для Claude Code, автоматизирующий создание UV-развёрток в Blender через MCP. Применяется при подготовке мешей к текстурированию и экспорту в игровые движки.
MIT 672 установок ★ 4 589 обновлён 2026-11-06
npx skills add arjun988/blender-skills --skill uv-workflow -a claude-codeЧто делает uv-workflow
Этот скилл помогает выстраивать UV-лейауты с единой плотностью текселей. Он управляет разметкой швов, упаковкой островов, настройкой UDIM и созданием UV-каналов для запечённого освещения.
Агент использует скрипты для автоматической маркировки швов, выполнения развёртки и контроля перекрытий. При работе над модульными наборами или сложными героями скилл проверяет эффективность упаковки и соблюдение границ островов. Для корректной работы в проекте нужно заранее настроить окружение Blender с поддержкой MCP-интеграции.
Какие задачи решает
- спрятать швы развёртки в скрытых зонах
- выровнять плотность текселей между деталями
- настроить UDIM-тайлы для высокодетализированных объектов
- создать отдельный UV-канал для лайтмапов
- упаковать UV-острова с нужными отступами
Примеры запросов агенту
- Примени
uv-workflowдля автоматизации разметки швов на текущей модели - Проверь плотность текселей модели через
uv-workflow - Запусти валидацию UV-развёртки с помощью
uv-workflowперед экспортом
Как установить uv-workflow
1Через Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill uv-workflow -a claude-code2Вручную: положить файлы
~/.claude/skills/uv-workflow/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/uv-workflow/
1Через Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill uv-workflow -a codex2Вручную: положить файлы
.agents/skills/uv-workflow/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill uv-workflow -a cursor2Вручную: положить файлы
.cursor/skills/uv-workflow/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/uv-workflow2Вручную: положить файлы
.github/skills/uv-workflow/SKILL.md1Через Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill uv-workflow -a gemini-cli2Командой платформы
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/uv-workflowВручную: положить файлы
.devin/skills/uv-workflow/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill uv-workflow -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об uv-workflow
Как установить uv-workflow в Claude Code?
Выполните команду npx skills add arjun988/blender-skills --skill uv-workflow -a claude-code в терминале.
Что делает uv-workflow?
Скилл автоматизирует процесс UV-развёртки, включая маркировку швов, упаковку островов, расчёт плотности текселей и подготовку каналов для лайтмапов в Blender.
Что нужно для работы uv-workflow?
Для работы необходим установленный Blender с настроенным доступом через MCP.
Исходный текст
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