- 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-rigging -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-rigging -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-rigging -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-rigging -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-riggingDel publicador
Expert rigging means the rig is specified by bone placement, proven by deformation under stress
poses, and shaped around what the animator will actually use. The stance of every source expert:
place joints precisely, generate or build the simplest mechanism that works, then pose it, measure
it, render it and fix it before calling it done. 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).
Module: scripts/bx_rig.py (tested on 5.2.1, headless and GUI).
import sys; sys.path.append("<skills>/scenario-blender-rigging/scripts"); import bx_rig as R.
parent_set returns FINISHED while a warning says bone heat
failed; measure unweighted vertices and empty deform groups, and fall back to a voxel proxy plus
Data Transfer (CGDive; verified). They also leak across the crotch and armpits: strip .L weights
from the right half.R.model_check([body, *parts], fix=True): transforms applied (shape keys
included), feet on Z=0, centered on X, facing -Y, about 1.8 m for an adult human. Apply Mirror
modifiers or keep their mirror object. GATE: model_check(...)["problems"] == [].lm = R.landmarks(body, eyes=eyes): cross-sections find crotch, hips, ankle,
neck, armpit, wrist; eye centers from the eye mesh; nose tip and chin from the face profile.
Override any joint with overrides={...}. GATE: joint order sane, lm["notes"] empty or
explained.meta = R.add_metarig("basic"|"human"), R.fit_metarig(meta, lm) (joints as
shared points, pre-bends, hinge rolls, left side symmetrized; hands and face by similarity,
coarse). Manual: build the deform skeleton with new_bone from the same landmarks. GATE:
R.check_metarig(meta, body) == [] AND
R.placement_sheet([body, eyes], out, arm_obj=meta, views=("front","right","top")) looked at;
zoom the head with center=, size=.R.upgrade_face(meta) (irreversible; eyelid follow Z 0.3,
bottom lip 0.9, Overwrite Widget Meshes on). Stylized hero face: bones for jaw, eyes, tongue plus
shape keys instead (stage 7).rig, err = R.generate(meta); err is the first Rigify error line naming
the bone ("Cannot connect chain - bone position is disjoint", "Expected 2 eye corners"): fix the
metarig, regenerate. Manual: twist chains, FK/IK layers with settings properties, IK with solved
pole angle, foot roll, symmetrize, mirror_drivers, make_def_layer, organize, widgets. GATE
(manual): static_cycles == [], cycle_check() == [], root_test < 1e-4, FK and IK coincide at
rest, pole error < 1e-3.rep = R.bind(rig, body, garments=[shirt, pants], rigid={eyes: None, teeth: "DEF-teeth.T"}):
auto weights, verification, proxy fallback, cross-side strip, garment transfer (applied), rigid
islands, clean and normalize, Armature after Mirror and before Subdivision. GATE: rep["ok"],
unweighted == 0, no non-deform groups; for export max_influences=4.dr = R.deformation_report(rig, [body, *garments], R.RIGIFY_POSES),
R.flag_report(dr), then R.pose_sheet(...) and close-ups and LOOK at
them. GATE: no leaks, no unexplained collapse, renders acceptable at armpit, elbow, wrist twist,
groin, knee, collar.Code (all in bx_rig): check_metarig, weight_report (unweighted, empty_major,
non_deform_groups, over4, sum_dev, mirror_err), deformation_report + flag_report (strain, joint
volume bands, cross-side leak, new self-intersections via bx_audit), static_cycles, cycle_check,
root_test, twist_angles, solve_pole_angle, rigid_check.
Visual: placement sheet (front, right, top; head zoom) before generating; pose sheet of
RIGIFY_POSES (front, right, three-quarter); joint close-ups (arm joints front/top/three-quarter,
others front/right/three-quarter) at every flagged pose. Look for armpit collapse, pointy or pinched
elbows and knees, candy-wrapper wrists, groin and butt volume, collar clipping, garments sliding or
intersecting, teeth and eyes lagging, widgets hidden inside the mesh. Numbers passed while a render
showed broken arms or crease spikes during testing: always open the render. Rubric:
references/critique.md.
Face capture apps, engines and lip-sync tools find shape keys by exact name. A key named with the
wrong case (JawOpen) or still equal to the Basis animates nothing. Both survive FBX and glTF
export [verified], so the file looks complete.
R.SHAPE_SETS: "arkit" (Apple's 52 names) and "visemes" (Meta Lipsync's 15, sil to U).
Lists, sources and Roblox's 50 FACS poses:
references/face-shapes.md.R.shape_set(face, "arkit", rename={"JawOpen": "jawOpen"}) renames, then adds each missing key at
value 0 as a copy of the Basis, and returns the names it created. Existing keys keep their value:
set every key to 0 before export, or the face deforms at rest.R.mirror_shape_key(face, n, n[:-4] + "Right")
for every n in R.ARKIT_52 ending in Left.R.shape_report(face, "arkit"). GATE: missing, wrong_case and side_conflicts
empty, left_is == "+X".empty is the list of keys still to sculpt: report it when delivering placeholders, empty it for
a final head. The sil viseme is the neutral face, so it always stays in empty..L side) and check one
capture take before sculpting the whole set.enable_rigify); the Human metarig still has the legacy
face (upgrade it); Overwrite Widget Meshes still defaults off.edit_bones.new() joins no
collection; pose selection is pose.bones[n].select.parent_set appends the Armature modifier last; weight operators (vertex_group_smooth,
_clean) need Weight Paint mode headless; bx_rig does clean, normalize and limit on data
instead.shape_key_add leaves new keys at value 1.0 in 5.2.1: set 0 before driving [verified].
VertexGroup.remove with out-of-range indices crashes 5.2.1 [verified].tail moves a connected child's head; EditBone.transform on a connected
group double-moves shared ends [verified]: use transform_bones.remap_driver). Action constraints pick
the action slot automatically. Only Insert Available is on by default; keyframe_insert from
Python is unaffected.use_transform_at_custom_shape), Use As Pivot
(use_transform_around_custom_shape). 5.2 adds Duplicate and Rename and Add Bone align Axes.references/procedures.md: full tested code for each stage and the
test script behind it; load before writing rig code.references/expert-notes.md: judgment by expert (placement, Rigify
internals, weighting, mechanisms, faces) with timestamps; load when a decision is not covered
above.references/critique.md: the review rubric; load at every gate.references/face-shapes.md: ARKit, viseme and Roblox FACS names with
their sources; load when naming face shapes for an engine or capture app.references/sources.md: videos, experts, best timestamps.Use when rigging a character, creature or prop in Blender through Python: "rig this character", Rigify metarig fitting or generation errors, automatic weights or "Bone Heat Weighting failed", weight p
---name: scenario-blender-riggingdescription: Use when rigging a character, creature or prop in Blender through Python: "rig this character", Rigify metarig…---# skills/dcc/blender/scenario-blender-rigging/SKILL.mdResumen general
Use when rigging a character, creature or prop in Blender through Python: "rig this character", Rigify metarig fitting or generation errors, automatic weights or "Bone Heat Weighting failed", weight painting fixes, clothes that do not follow, IK/FK switch, foot roll, twist bones, drivers and custom properties, corrective shape keys, a stylized face rig, ARKit 52 blend shapes or viseme shape keys for face capture, lip sync or a game engine, a mechanical or hard-surface rig, or testing how a rig deforms.
Preguntas frecuentes
Descarga skills/dcc/blender/scenario-blender-rigging/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.
R.joint_sheet(...)strip_opposite_side, assign_rigid, smooth_weights with a vertex mask,
clean_weights). Volume at deep bends: corrective shape keys (volume_restore_targets,
corrective_from_targets, corrective_driver). Blender-only candy wrapper:
preserve_volume_mask. Re-run stage 7 after every fix; re-check earlier poses (CGDive).rig_ui.py needs Auto Run in a GUI, switches exactly 0 or 1,
rest pose clean, test action removed. Report numbers, renders and what was not verified.