blender-retopology-uv — скилл для Claude Code: установка
Скилл blender-retopology-uv для Claude Code помогает переделать скульпт или скан в игровую сетку и подготовить UV для текстурирования и запекания. Включается при работе с ретопологией и развёрткой в Blender 5.3.
MIT 603 установок ★ 2 624 обновлён 2026-11-13
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a claude-codeЧто делает blender-retopology-uv
Скилл описывает автоматическую и ручную ретопологию, настройку потока рёбер для деформируемых моделей и подготовку UV. Автоматические методы Quadriflow, Decimate и planar подходят для разных типов сеток; скрипт scripts/auto_retopo.py создаёт объект с суффиксом _low и скрывает исходник. Для развёртки доступны методы по швам, Minimum Stretch и Smart.
Скрипты scripts/uv_pack.py и scripts/texel_density.py помогают отметить швы на резких рёбрах, упаковать острова с пиксельными отступами и измерить плотность текселей. Есть инструкции для lightmap UV2, UDIM и зеркальных UV. Для измерения плотности сначала применяют масштаб объекта; иначе результат будет неверным. Модель выполнения описана в blender-core.
Какие задачи решает
- сделать игровую низкополигональную сетку из скульпта или скана
- выбрать метод ретопологии для органической или hard-surface модели
- разложить швы и упаковать UV-острова с заданным отступом
- измерить и выровнять плотность текселей модели
Примеры запросов агенту
- Подготовь игровую сетку из объекта
Sculptметодомquadriflowна 8000 треугольников. - Разложи UV модели по швам и упакуй острова с отступом для текстуры 2k.
- Измерь плотность текселей модели с разрешением 2048 и задай её через
--set.
Как установить blender-retopology-uv
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a claude-code2Вручную: положить файлы
~/.claude/skills/blender-retopology-uv/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/blender-retopology-uv/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a codex2Вручную: положить файлы
.agents/skills/blender-retopology-uv/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a cursor2Вручную: положить файлы
.cursor/skills/blender-retopology-uv/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/blender-skills skills/blender-retopology-uv2Вручную: положить файлы
.github/skills/blender-retopology-uv/SKILL.md1Через Skills CLI (Vercel)
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a gemini-cli2Командой платформы
gemini skills install https://github.com/EL4CTEO/blender-skills --path skills/blender-retopology-uvВручную: положить файлы
.devin/skills/blender-retopology-uv/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о blender-retopology-uv
Как установить blender-retopology-uv в Claude Code?
Выполни npx skills add EL4CTEO/blender-skills --skill blender-retopology-uv -a claude-code. Файл скилла находится по пути ~/.claude/skills/blender-retopology-uv/SKILL.md.
Что делает blender-retopology-uv?
Скилл описывает ретопологию моделей и работу с UV в Blender: от создания низкополигональной сетки до развёртки, упаковки островов и настройки плотности текселей.
Что нужно для работы blender-retopology-uv?
Инструкции рассчитаны на Blender 5.3. Модель выполнения скилла находится в blender-core.
Исходный текст
SKILL.md · MIT
--- name: blender-retopology-uv description: Retopology and UVs in Blender 5.3 - auto retopo (Quadriflow, Decimate, planar), deformation edge flow, seams, unwrap (Angle Based, Minimum Stretch, Smart), pixel-margin packing, texel density measure/set, lightmap UV2, UDIMs, mirrored UVs. Use to turn sculpts/scans/AI meshes into game meshes or prep UVs for texturing/baking. license: MIT metadata: author: blender-agent-skills version: "1.2.0" --- # Retopology & UVs The execution model is in `blender-core`. ## Retopology **Automatic** (`scripts/auto_retopo.py -- --objects Sculpt --tris 8000 --method ...`) makes `<name>_low` and leaves the source hidden: | Method | Use for | Notes | |---|---|---| | `quadriflow` | organic props, static characters, scans | clean quads. Voxel-remeshes first so the input is manifold (retries on the source if that fails); UVs are lost (re-unwrap) | | `decimate` | background props, LODs, AI-generated meshes | keeps UVs/shape, gives triangles. Fast | | `planar` | hard-surface CAD/boolean results | dissolves flat areas; keeps seams/sharp/material/UV borders | **Manual** (hero characters, anything that deforms). Set up a new mesh object with a Shrinkwrap modifier (`PROJECT`, target = sculpt), snapping to `FACE_PROJECT` + `use_snap_project`, and the source in a different viewport color/x-ray. Clean loops with `mesh.relax_edge_loops` / `space_edge_loops_evenly` (LoopTools, built in since 5.3). Auto retopo isn't good enough for deforming hero meshes, because the edge flow below matters. ### Edge flow rules for deforming meshes - Concentric loops around the eyes and mouth (≥3 rings). The nasolabial loop flows from the nose wing to the mouth corner. - **3 loops** at every bending joint (elbow, knee, finger knuckles), plus a loop on each side to keep volume. The shoulder needs extra loops for raising the arm. - Keep poles (3/5-edge verts) out of bending areas. Put them on flat, stiff regions (chest, back of skull). - Distribute quads evenly, with density where deformation and silhouette need it. Use triangles only in hidden, non-deforming spots. - Character tri budgets in 2026: mobile 5–15k, Roblox body ≤ 10.7k total, console/PC third-person 30–80k, hero/cinematic 100k+. Check the target in `blender-game-optimization`. ## UVs 1. **Seams**: hide them (under arms, inner legs, back of the head, under parts), follow hard edges, cut cylinders on the back side. Rule for game meshes: every hard edge (>~60°, `sharp_edge`) **must** be a UV seam, or the normal map shows artifacts. `scripts/uv_pack.py --seams-from-sharp 60` does this. 2. **Unwrap**: `--method seams` (Angle Based with marked seams), `--method min_stretch` (SLIM, 4.3+, least distortion on organics), `--method smart` (hard-surface/auto, `--angle 66`). 3. **Straighten** rectangular islands (Follow Active Quads, live only) so trims and pixel grids line up. 4. **Average island scale + pack** with margin in pixels: 2k → 8 px, 4k → 16 px, mobile 1k → 4 px. `--shape CONCAVE` gives the tightest pack (slow headless). The default `AABB` is instant. 5. **Texel density** (`scripts/texel_density.py --res 2048`): keep `spread` ≤ 1.3 within an asset. Set it with `--set <px/m>`; if `fits_0_1` is false, change res or density. 6. QA: `blender-asset-qa` reports zero-area UV faces and overlap %. ### Texel density targets (px/m; studio baselines, not laws) | Context | px/m | |---|---| | First-person hero / weapons | 1024–2048 | | First-person environment | 512–1024 | | Third-person games | 512 (console/PC), 256 (mobile) | | Top-down / strategy | 128–256 | | Roblox | ~256–512 per texture: 5×5 studs → 256², 10×10 → 512², 20×20 → 1024² | Everything in the same scene should share one density. The exception is hero assets, kept within 2x. ## Special cases - **Mirrored/stacked UVs** save space but break unique bakes. Move the duplicate islands exactly +1 U (outside 0–1) during baking, then move them back. Their normal maps must be mirror-safe (tangent space handles it in engines with MikkTSpace). - **Lightmap UV2** (`--lightmap`, gives `UVMap_Lightmap`): no overlaps, every island inside 0–1, generous margin. Unreal/Unity can generate their own; ship one only if the engine pipeline wants it. Keep UV0 active for texturing. - **UDIMs** (film/hero): islands in tiles 1001+ (U offset 1 per tile). Texture node image `source="TILED"`. Game engines mostly don't support UDIMs. - **Trim sheets**: unwrap the strips, then scale/move the islands onto the trim rows (V positions from the trim layout). Islands may exceed 0–1 in U for tiling. - **Roblox**: exactly one UV set, all inside 0–1. Overlaps are allowed. ## Gotchas - 5.0+: UV selection is shared across UV maps (`.uv_select_*` attributes). Old `BMLoopUV.select` code fails. - `uv.*` operators run in Edit Mode and act on selected faces. Select everything first (scripts handle this). - Headless `uv.pack_islands` with `CONCAVE`/`CONVEX` + rotation can take 2–25 s even on tiny meshes. Use `AABB` while iterating. - Unwrap warning "failed to solve island": the island has no seams (closed shape). Add seams. - Apply scale before measuring texel density, or the density reads wrong (the scripts use world space and already account for scale).
© blender-agent-skills · MIT · EL4CTEO/blender-skills