scenario-blender-retopology
Use when turning a dense sculpt, scan or AI-generated mesh into clean topology in Blender, for animation, subdivision or a game low poly with a triangle budget.
Install / Use
npx skills add scenario-labs/skills --skill scenario-blender-retopologyInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of scenario-blender-retopology
scenario-blender-retopology scores 89/100 on our quality scale, 128th of 354 Other skills we index (top 37%).
Its SKILL.md is 22 KB long, well organised into 10 sections with 1 code example: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-blender-retopology is actively maintained.
- Our last check on 2026-11-22 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-blender-retopology compared with similar skills
All 4 of these similar skills score higher than scenario-blender-retopology; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-blender-retopology (this skill)by scenario-labs | 89 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-blender-retopology?
- Run
npx skills add scenario-labs/skills --skill scenario-blender-retopology. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-blender-retopology work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-blender-retopology safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-blender-retopology still maintained?
- The repository was last updated 35 days ago, so scenario-blender-retopology is actively maintained.
Skill content
View source on GitHubname: scenario-blender-retopology description: "Use when turning a dense sculpt, scan or AI-generated mesh into clean topology in Blender, for animation, subdivision or a game low poly with a triangle budget. Also when choosing between QuadriFlow or voxel remesh and manual retopo, placing loops around eyes, mouth and joints, deciding pole placement, setting up a Shrinkwrap cage, fixing volume loss after subdivision, preparing a low poly for baking, or auditing topology for spirals, 6-poles and triangles. Keywords: retopo, retopology, quad remesh, clean up an AI mesh, edge flow, low poly, bake prep." license: MIT
Blender retopology
Expert retopology is a plan executed with the fewest loops that capture the forms and let the mesh
deform: loops close around eyes, mouth and joints, poles sit where nothing moves, and the subdivided
surface, not the cage, matches the sculpt. An agent without a mouse can build every piece of this
from data, but it reaches expert quality only on the parts it plans explicitly. Automatic remeshing
is a finish for static assets and a start for everything else. If a sibling skill named here is
missing from your available skills, load it with skill_get (Scenario MCP) or ask the user to
install it (https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas
and flag the gap.
REQUIRED BACKGROUND: scenario-blender-expert (execution channel, review loop, 5.2 API changes).
Toolkit: scripts/bx_retopo.py
(import sys; sys.path.append("<skills>/scenario-blender-retopology/scripts"); import bx_retopo as R),
all coordinates in the sculpt's local space.
Stance (the expert delta)
- Map first, as data. Kaspar draws six layers on the sculpt before any vertex: edge flow,
primary creases, secondary (expression-only) creases, articulation, expression bounds, landmarks
(BCON22 [00:07:55], shown in frames 00:07:53 to 00:14:38). The agent writes the same map as
coordinates and loop counts (landmarks from renders plus
R.surface_point), then builds. - Loops are the budget, not vertices. Articulation minimum (Kaspar after Brian Tindall): lids, lips and brows as curves with 3 controls and 2 handle loops each, plus 2 corner loops on eyes; upper count = lower count (Dikko, Kaspar, Kenny); 3 loops per joint; a crease is 1 loop on it plus 2 hugging it. Elsewhere "as much as it needs to be" (Kaspar Live #3 [01:56:33]).
- Poles: valence 3 or 5, where nothing moves, never on a crease loop, a shell rim or the face center line (Kaspar Live #7 [00:11:41], Live #3 [00:36:54]; Dikko [00:04:49]). Lampel's reason: pinching is a density jump in the subdivided result, harmless on flat still areas (BCON24 [00:21:18]). [added] An agent's poles come from ring-count reductions (4 per unit) and from cut borders that staircase across an auto base (about half their vertices): budget both.
- Loops close on themselves. A spiral around eyes or lips means rebuild (Dikko); a spiral that terminates in a still area is tolerated (Dikko body [00:09:34], Kaspar nose).
- Judge the subdivided surface. A snapped cage shrinks inside when subdivided; a Shrinkwrap
offset fixes convex areas and worsens cavities. Fit the cage so its subdivided surface matches
(Duha BCON23 [00:08:58]):
R.fit_subdiv. Kaspar's Multires Apply Base does the same job but overshoots (measured below). - Game low poly = silhouette plus animation loops (SpeedChar): face about 3x body density, triangles wherever nothing bends, twisted quads cut by hand so baker and engine agree, low poly slightly proud of the high; every hard edge is a UV seam (On Mars 3D).
- Auto-remesh fits static, scanned, background or bake-only assets (Lampel [00:09:05], Grant Abbitt, Duha, Jamie Dunbar). For deforming characters it lacks the judgment calls: on the sheep, QuadriFlow at expert density gave no rings around eyes or mouth and tore a thin ear.
Establish first
| Input | Why it changes the plan | Default when silent |
| -------------- | ------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------- |
| Purpose | film cage renders at subdivision 2 (Kaspar); game ships triangles and bakes | deforming character: film-style all-quad cage |
| Budget | film: no vertex budget, minimum loops (Kaspar); game: triangle budget | film stylized head 1,650 to 4,100 faces, body 9,400 to 16,500 (Blender Studio meshes); game character < 10,000 tris |
| Deformation | face rig, joints, how far the mouth travels (expression bounds) | face + limbs deform |
| Camera | detail and density follow the closest view (SpeedChar) | close-up face |
| Style | stylized: creases in topology; realistic: generic base + displacement (Kaspar) | stylized |
| Symmetry | R.topology_report(sculpt)["sym_local_pct"], local space | Mirror only above ~98 % (the sheep is 21 %, posed) |
| Separate parts | eyes, teeth, hair clumps, clothing (from the body duplicate) | separate objects |
Workflow
-
Inspect (procedures P1): holes, manifoldness, scale, rotation, symmetry. GATE: all four written down.
-
Map: read the sculptor's face sets first (
R.face_set_map,R.face_set_review, P1b: lip line, eye masks, ears, hooves); landmarks with coordinates, loop counts per feature from the Numbers table, crease list (check expression shape keys), per-part density. GATE: map exists before any geometry. -
Choose a method per part:
| Part | Method | Evidence | | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- | | Eyes, mouth, brows (deforming) |
carve_rings(corners=, count=(lo, hi)): upper = lower by construction, geodesic rings, the border's count kept when inside the range; pair odd boundaries first (parity_strip) | v2: eyes 24 (12/12), mouth 30 (15/15) on every clean ring; forcing Kaspar's 18/24 cost 40 more poles | | Nasolabial, face frame, neck (map lines) |carve_bandalongenclosing_contourof face sets (P7): one clean loop, poles pushed onto the base | v2: nasolabial +18 poles; face frame opt-in, +64 poles on the sheep | | Limbs, ears, tail, fingers, horns |limb_profile(geodesic contours, root and joints found) +socket_tube(count=)(P3b, P8); straight parts:tubefrom sections | v2: all 7 parts incl. the 1 m curled tail, 3 rings per joint | | Skull, torso, smooth masses | QuadriFlow start acceptable, else grid patches | little deformation | | Static prop, scan, bake-only | QuadriFlow whole object (R.quadriflow) | Lampel, Grant Abbitt | | Realistic human head | shrinkwrap a clean generic base mesh, then fit (Kaspar BCON22 [00:20:16]) | not scripted here | -
Build islands separately and roughly (Kaspar: "don't focus on tweaking all the points"). Stack via
R.setup_cage(Mirror clip > Shrinkwrap Target Normal Project > Subsurf hidden in edit mode). GATE: topology gate below passes per island. -
Relax and freeze hand-built layouts:
R.relax,R.freeze. Not after QuadriFlow (worsened coverage 0.44 % to 0.55 %). -
Connect by counts:
R.boundary_loops, thenR.bridge/R.weld_loopson equal counts; reduce the larger side first (Kaspar: wrist 10 vs hand 16 was "six too many"). GATE: no triangles created. -
Volume: film
R.fit_subdiv(gentle defaults); gameR.push_outsidethenR.triangulate_twistedand a Triangulate modifier on export. -
Review and hand off: gates, two render sheets, handoff hygiene (P13). Report what the agent did not plan.
What an agent reaches (measured on the sheep; tests/code/blender-retopology/sheep_results.json and compare/metrics.json)
| Strategy | Faces | Subdiv-2 mean error | Inside | Eye / mouth rings | Closed-loop edges | Looks |
| -------------------------------------------------------------------------------------------------------------------------- | ----- | ------------------- | ------ | ---------------------------------------------- | ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| Kaspar's own retopo | 2,596 | 0.24 % | 47 % | 5,5 / 2 | 29.9 % | clean, reads unsubdivided |
| QuadriFlow, area-matched budget | 4,372 | 0.14 % | 87 % | 0 / 0 | 1.6 % | faceted, torn ear, uniform density |
| + gentle fit_subdiv | 4,372 | 0.045 % | 53 % | 0 / 0 | 1.6 % | smooth masses, lumpy hooves |
| + Multires Apply Base instead
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
