blender-retopology-uv
Skill1.2k starsChanged 3 days agoMITView on GitHub
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.
Trending
More talk lately.about the whole repository
Who's talking about EL4CTEO/blender-skills
- sudosubin/agents.nix“claude-code-marketplaces.github.el4cteo.blender-skills: init at 1.3.1”GitHub · Nov 16, 2026
- sudosubin/agents.nix“agent-skills.github.el4cteo.blender-skills: 1.3.0 → 1.3.1”GitHub · Nov 13, 2026
- sudosubin/agents.nix“agent-skills.github.el4cteo.blender-skills: 1.2.0 → 1.3.0”GitHub · Nov 13, 2026
- akhmadilham/pinax-registry“[Skill Proposal]: blender-skills”GitHub · Nov 3, 2026
- sudosubin/agents.nix“agent-skills.github.el4cteo.blender-skills: 1.1.0 → 1.2.0”GitHub · Oct 30, 2026
The biggest 5 of 18 mentions linking to the repository that our crawl found. Each line is their own headline.
See all 18
Talked about on GitHub (18 times).
On GitHub · 18
- Nov 16, 2026claude-code-marketplaces.github.el4cteo.blender-skills: init at 1.3.1 — sudosubin/agents.nix0 reactions
- Nov 13, 2026agent-skills.github.el4cteo.blender-skills: 1.3.0 → 1.3.1 — sudosubin/agents.nix0 reactions
- Nov 13, 2026agent-skills.github.el4cteo.blender-skills: 1.2.0 → 1.3.0 — sudosubin/agents.nix0 reactions
- Nov 3, 2026[Skill Proposal]: blender-skills — akhmadilham/pinax-registry0 reactions · 1 comment
- Oct 30, 2026agent-skills.github.el4cteo.blender-skills: 1.1.0 → 1.2.0 — sudosubin/agents.nix0 reactions
13 more on GitHub
- Oct 19, 2026feat(agents): install blender-skills globally for all agents — zigrivers/mac-launchpad0 reactions
- Oct 18, 2026[Candidate] el4cteo/blender-skills/skills/blender-hardsurface-modeling - blender-hardsurface-modeling — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 18, 2026Mac Codex: audit and learn upstream Blender Agent Skills with isolated pilot — hengqi61-maker/muscle-atlas0 reactions · 2 comments
- Oct 17, 2026[Candidate] el4cteo/blender-skills/skills/blender-geometry-nodes - blender-geometry-nodes — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 17, 2026[Candidate] el4cteo/blender-skills/skills/blender-game-optimization - blender-game-optimization — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 17, 2026[Candidate] el4cteo/blender-skills/skills/blender-facial-shapekeys - blender-facial-shapekeys — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-export-pipelines - blender-export-pipelines — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-core - blender-core — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-character-rigging - blender-character-rigging — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026agent-skills.github.el4cteo.blender-skills: init at 1.1.0 — sudosubin/agents.nix0 reactions
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-asset-qa - blender-asset-qa — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-animation - blender-animation — ProSkillsMD/proskills0 reactions · 1 comment
- Oct 16, 2026[Candidate] el4cteo/blender-skills/skills/blender-addon-development - blender-addon-development — ProSkillsMD/proskills0 reactions · 1 comment
In this repository29 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- blender-addon-developmentSkill
- blender-animationSkill
- blender-asset-qaSkill
- blender-character-riggingSkill
- blender-clothingSkill
- blender-coreSkill
- blender-environment-kitsSkill
- blender-export-pipelinesSkill
- blender-facial-shapekeysSkill
- blender-game-optimizationSkill
- blender-geometry-nodesSkill
- blender-hair-groomingSkill
- blender-hardsurface-modelingSkill
- blender-lighting-lookdevSkill
- blender-pbr-materialsSkill
- blender-pipeline-automationSkill
- blender-renderingSkill
- blender-scene-setupSkill
- blender-sculptingSkill
- blender-simulationSkill
- blender-stylized-nprSkill
- blender-texture-bakingSkill
- blender-texturingSkill
- blender-time-of-daySkill
- blender-video-editingSkill
- blender-weather-fxSkill
- blender-workflow-recipesSkill
The file
We split this skill into the rules it gives an agent
1 rule. About 0 are common, 1 is distinctive, and 0 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈1
Distinctive · estimate
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 27
Keep poles (3/5-edge verts) out of bending areas.
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
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
- 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 60does this. - 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). - Straighten rectangular islands (Follow Active Quads, live only) so trims and pixel grids line up.
- Average island scale + pack with margin in pixels: 2k → 8 px, 4k → 16 px, mobile 1k → 4 px.
--shape CONCAVEgives the tightest pack (slow headless). The defaultAABBis instant. - Texel density (
scripts/texel_density.py --res 2048): keepspread≤ 1.3 within an asset. Set it with--set <px/m>; iffits_0_1is false, change res or density. - QA:
blender-asset-qareports 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, givesUVMap_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). OldBMLoopUV.selectcode fails. uv.*operators run in Edit Mode and act on selected faces. Select everything first (scripts handle this).- Headless
uv.pack_islandswithCONCAVE/CONVEX+ rotation can take 2–25 s even on tiny meshes. UseAABBwhile 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).
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

