retopology — Blender skill: what it does, how to install
retopology — a skill for creating production-ready, quad-dominant meshes in Blender. It initializes during mesh processing after high-poly sculpting or scanning.
MIT 667 installs ★ 4,589 updated 2026-11-06
npx skills add arjun988/blender-skills --skill retopology -a claude-codeWhat retopology does
The tool manages retopology workflows for animation-ready assets by enforcing edge loops, proper polygon flow, and efficient topology. It ensures deformation zones use quads while maintaining silhouette accuracy and polycount budgets.
It integrates via MCP in Blender. The agent uses scripts to handle guide setup, apply Shrinkwrap modifiers, and validate geometry against rig requirements before UV unwrapping.
What it helps with
- prepare high-poly models for rigging
- reduce polycount while maintaining silhouette
- fix topology for character facial expressions
- validate mesh manifold status before UV mapping
Example prompts for the agent
- Create a retopology mesh for the character
- Check current polycount during retopology
- Optimize edge loops around shoulder deformation zones
How to install retopology
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill retopology -a claude-code2Manually: put the files in place
~/.claude/skills/retopology/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/retopology/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill retopology -a codex2Manually: put the files in place
.agents/skills/retopology/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill retopology -a cursor2Manually: put the files in place
.cursor/skills/retopology/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install arjun988/blender-skills .claude/skills/retopology2Manually: put the files in place
.github/skills/retopology/SKILL.md1Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill retopology -a gemini-cli2Platform CLI
gemini skills install https://github.com/arjun988/blender-skills --path .claude/skills/retopologyManually: put the files in place
.devin/skills/retopology/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add arjun988/blender-skills --skill retopology -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about retopology
How to install retopology in Claude Code?
Run npx skills add arjun988/blender-skills --skill retopology -a claude-code.
What does retopology do?
It generates animation-ready topology in Blender, controlling edge loops and polygon flow through MCP commands.
What is required to use retopology?
You need Blender installed and configured with MCP access to allow the agent to modify project files.
Source text
SKILL.md · MIT
---
name: retopology
description: Production retopology for animation-ready, low-poly, quad-dominant meshes with proper edge loops and efficient polygon flow. Use after sculpting or high-poly modeling before rigging and UV work in Blender via MCP.
license: MIT
metadata:
author: https://github.com/arjun988
version: "1.0.0"
domain: blender
role: specialist
triggers: retopo, retopology, edge loop, quad, topology, animation ready, poly reduction, remesh
related-skills: character-artist, creature-artist, sculpting, uv-workflow
---
# Retopology
Clean, purposeful topology for deformation, UVs, and performance. Quad-dominant. Animation-ready.
## When to Use
- After sculpting high-poly characters/creatures
- Before rigging any deforming mesh
- Poly reduction while preserving silhouette
- Fixing topology from boolean or scan cleanup
## Workflow
```
High-Poly Reference → Guide Setup → Block Retopo → Loop Refinement
→ Pole Placement → Triangle Cleanup → Validation → UV Handoff
```
## Retopology Methods
| Method | Best For | Speed |
|--------|----------|-------|
| Manual (Poly Build tool) | Hero characters | Slow, best quality |
| Shrinkwrap retopo | Creatures, organic | Medium |
| Quad Remesh (voxel) | Quick blockout retopo | Fast, needs cleanup |
| Instant Meshes (external) | Background assets | Fast |
| Symmetry retopo | Bilateral characters | Medium |
**Production default:** Manual with shrinkwrap for hero; Quad Remesh + cleanup for background.
## Edge Loop Rules
- Loops follow muscle/deformation direction
- One loop per major form change
- Maintain even edge length in deformation zones
- Redirect loops at poles (minimum 3 edges meeting)
- Hide poles at back of head, armpits, groin
## Pole Management
| Location | Acceptable | Avoid |
|----------|------------|-------|
| Top of head | 3–5 pole | — |
| Inner eye corner | Redirect pole | Pole directly at corner |
| Shoulder | 3-edge pole hidden | Star pattern on deltoid |
| Back of knee | Pole in crease | Pole on front of knee |
## Triangle Policy
- Triangles OK on non-deforming static mesh
- Convert tris to quads on face, joints, fingers
- No n-gons on deforming surfaces
- Tris at hidden areas (scalp under hair, mouth interior)
## Polycount Targets
See `../references/polycount-budgets.md`. Retopo is where budget is enforced.
## Shrinkwrap Retopo Setup
```
1. Duplicate high-poly to reference collection (hidden in render)
2. Create retopo mesh with Poly Build / manual extrude
3. Shrinkwrap modifier → Target: high-poly
4. Snap to face with project individual elements
5. Validate shrinkwrap distance (no intersection)
```
## Validation Checklist
- [ ] Quad-dominant on all deformation areas
- [ ] Edge loops support planned rig joints
- [ ] No non-manifold geometry
- [ ] Silhouette matches high-poly reference
- [ ] Polycount within budget
- [ ] Poles placed at acceptable locations
- [ ] Mesh manifold and watertight (if required)
## MCP Integration
1. Create retopo mesh object via MCP
2. Apply shrinkwrap modifier via MCP
3. Query face/edge count during retopo
4. Compare silhouette via MCP render/query
5. Transfer to `COL_Geo_LowPoly` collection
## Constraints
### MUST DO
- Retopo before rigging deforming meshes
- Preserve silhouette vs high-poly reference
- Plan loops for facial expressions (characters)
- Enforce polycount budget
- Validate manifold before UV pass
### MUST NOT DO
- Auto-retopo without manual cleanup (hero assets)
- Leave n-gons on deformation surfaces
- Skip validation against reference
- Retopo without knowing rig requirements
- Uniform density (more density at face/hands)
## Reference Guide
| Topic | Reference | Load When |
|-------|-----------|-----------|
| Facial retopo | `references/facial-retopo.md` | Character faces |
| Game vs cinematic | `references/game-cinematic-topo.md` | Budget decisions |
© https://github.com/arjun988 · MIT · arjun988/blender-skills