Skip to main content
skill CX Codex

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

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

What 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-code

2Manually: put the files in place

~/.claude/skills/retopology/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/retopology/

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

Similar skills

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

From the same set57

The whole set →
animation This skill automates game-ready animation workflows in Blender. It activates when defining keyframes for characters or mechanical objects. CX Codex +1 675installs uv-workflow uv-workflow — a skill that automates UV unwrapping in Blender via MCP. Runs when preparing meshes for texturing and game engine export. CX Codex +1 672installs 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 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 lowpoly-style The lowpoly-style Claude Code skill guides low-poly art direction in Blender. It activates for retro game visuals built from simple shapes and atmospheric lighting. CX Codex +1 662installs prop-artist prop-artist — a skill for Claude Code, Codex, and others that models grounded, readable props and furniture. The agent manages scale, silhouettes, and detail tiers based on real-world reference logic. CX Codex +1 656installs camera-cinematography The camera-cinematography skill for Claude Code manages camera framing, lens selection, and movement animation in Blender. It runs when setting up cinematic sequences or planning shot layouts. CX Codex +1 653installs

Project sponsors

Companies that keep this analytics open