- name
SKILL.md
スキルファイルは公開元のリポジトリに置かれたままです。
コピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add scenario-labs/skills --skill scenario-blender-rigging -a cursor -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add scenario-labs/skills --skill scenario-blender-rigging -a claude-code -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add scenario-labs/skills --skill scenario-blender-rigging -a codex -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add scenario-labs/skills --skill scenario-blender-rigging -a grok -yコピーしたメッセージを Grok Bot のチャットで送信してください。Bot がこの SKILL.md を GitHub から取得し、すべての Bot が共有するスキルに追加します。
Install this skill: https://github.com/scenario-labs/skills/tree/HEAD/skills/dcc/blender/scenario-blender-rigging公開元より
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.md概要
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.
よくある質問
公開元から skills/dcc/blender/scenario-blender-rigging/SKILL.md をダウンロードするか、パスをコピーしてリポジトリを開いてください。PlugMCP はスキルを掲載するだけで、ファイルはホストしていません。
公開元は https://github.com/scenario-labs/skills で管理しています。
Claude、Cursor、Codex、Grok Build は、公開元のリポジトリから追加した SKILL.md を読み込めます。Grok Bot は、チャットでスキルの 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.