- name
SKILL.md
Le fichier du skill reste dans le dépôt de l'éditeur.
Collez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a cursor -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a claude-code -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a codex -yCollez la commande copiée dans un terminal. Elle installe ce SKILL.md dans cet agent.
npx skills add scenario-labs/skills --skill scenario-blender-retopology -a grok -yEnvoyez le message copié dans un chat Grok Bot. Le Bot récupère ce SKILL.md sur GitHub et l'ajoute aux skills que partagent tous vos Bots.
Install this skill: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/blender/scenario-blender-retopologyDe l'éditeur
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.mdVue d'ensemble
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.
FAQ
Téléchargez skills/dcc/blender/scenario-blender-retopology/SKILL.md auprès de l'éditeur, ou copiez le chemin et ouvrez le dépôt. PlugMCP répertorie le skill et n'héberge pas le fichier.
L'éditeur le maintient sur https://github.com/scenario-labs/skills.
Claude, Cursor, Codex et Grok Build peuvent lire un SKILL.md que vous ajoutez depuis le dépôt de l'éditeur. Grok Bot l'installe lorsque vous envoyez dans un chat le lien du dossier GitHub du skill.
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