- name
SKILL.md
El archivo de la skill permanece en el repositorio del publicador.
Pega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a cursor -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a claude-code -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a codex -yPega el comando copiado en una terminal. Instala este SKILL.md en ese agente.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a grok -yEnvía el mensaje copiado en un chat de Grok Bot. El Bot obtiene este SKILL.md de GitHub y lo añade a las skills que comparten todos tus Bots.
Install this skill: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/blender/scenario-blender-retopologyDel publicador
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.
R.surface_point), then builds.R.fit_subdiv. Kaspar's Multires Apply Base does the same job but
overshoots (measured below).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:
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 %).
tests/code/blender-retopology/sheep_results.json and compare/metrics.json)Numbers flatter the agent: an aggressive fit scored 0.043 % and looked lumpier than Kaspar's cage. What stays human-level only: articulation counts with handle loops, crease loops placed from expression shapes, pole routing and loop budgets out of the face. Say so in the report.
Code (thresholds [added], calibrated on Kaspar's sheep: 0.24 % mean, 47 % inside, coverage p95 0.82 %):
retopo_gate = R.topology_report(retopo)
fit_gate = R.fidelity(retopo, sculpt, levels=2)
gate = {"six_poles_to_justify": retopo_gate["valence_6plus"], "no_rim_poles": retopo_gate["rim_poles"] == 0,
"quads": retopo_gate["non_quads_visible"] == 0 or retopo_gate["quads_pct"] >= 99.0,
"subd_fit": fit_gate["mean_pct"] <= 0.3 and 40 <= fit_gate["inside_pct"] <= 60,
"coverage": fit_gate["cov_p95_pct"] <= 1.0, "loops": R.loop_stats(retopo)}
print(gate)
Edge-length CV is never pass/fail (studio meshes read 0.33 to 0.8); 6-poles are reported and
justified, not banned (studio 0 to 4). Also: crease_poles == 0, center_poles == 0 on mirrored
faces, R.loops_around(retopo, eye, normal, max_radius) returns at least 3 closed rings per eye and
mouth, ring counts equal before every merge, triangles only in hidden or rigid areas, budget met
(R.tri_count). Visual (bx_review, same views as the sculpt): cage in wire (rings close, no
wandering loops, poles in still areas) and subdivided matcap (lumps, pinching at poles, creases
held), then the cage alone: it must read without subdivision (Kaspar Finale [01:58:41]). Score with
references/critique.md.
overlay.show_retopology, offset 0.01 m since 4.5);
"Project Individual Elements" is snap_elements_individual = {'FACE_PROJECT'}. GUI only.bx_gui); headless use
R.relax. F2, LoopTools, BSurfaces are extensions; mesh.circularize, space_edge_loops_evenly,
flatten are built in; mesh.select_by_pole_count exists (4.4).sharp_edge is always honored since 4.1; Auto Smooth is gone (Smooth by Angle modifier).object.multires_base_apply(apply_heuristic=True); QuadriFlow lost its shortcut and
has the traps above.references/procedures.md: tested code, P0 to P14 (inspect, face sets
P1b, stack, tubes, geodesic limbs P3b, freeze/relax, annotations, QuadriFlow, map-line loops and
rings, sockets, volume, checks, game, expression test, handoff, AI-mesh finishing). Load before
writing any code.references/expert-notes.md: principles by expert with timestamps,
face and body loop maps, clothing, game rules, the sheep experiment in full. Load when planning a
face, body, clothing or game mesh.references/critique.md: the rubric to judge your own retopo. Load at every review.references/sources.md: all 24 source videos with best timestamps.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 o
---name: scenario-blender-retopologydescription: Use when turning a dense sculpt, scan or AI-generated mesh into clean topology in Blender, for animation…---# skills/dcc/blender/scenario-blender-retopology/SKILL.mdResumen general
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.
Preguntas frecuentes
Descarga skills/dcc/blender/scenario-blender-retopology/SKILL.md desde el publicador, o copia la ruta y abre el repositorio. PlugMCP lista la skill y no aloja el archivo.
El publicador lo mantiene en https://github.com/scenario-labs/skills.
Claude, Cursor, Codex y Grok Build pueden leer un SKILL.md que añadas desde el repositorio del publicador. Grok Bot lo instala cuando envías en un chat el enlace a la carpeta de la skill en GitHub.
Connect by counts: R.boundary_loops, then R.bridge / R.weld_loops on 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); game R.push_outside then
R.triangulate_twisted and a Triangulate modifier on export.
Review and hand off: gates, two render sheets, handoff hygiene (P13). Report what the agent did not plan.
R.triangulate_twisted