scenario-blender-rigging
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…
Install / Use
npx skills add scenario-labs/skills --skill scenario-blender-riggingInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
AutomationSupported Platforms
Our assessment of scenario-blender-rigging
scenario-blender-rigging scores 86/100 on our quality scale, 1789th of 2,758 Automation skills we index.
Its SKILL.md is 19 KB long, well organised into 11 sections and no code examples: 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-rigging is actively maintained.
- 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-rigging compared with similar skills
All 4 of these similar skills score higher than scenario-blender-rigging; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-blender-rigging (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| Agent-Reachby Panniantong | 100 | 114.0k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 82.3k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 80.5k | today | CLAUDE.md |
| Claude-Code-Game-Studiosby Donchitos | 100 | 40.6k | 12d ago | CLAUDE.md |
Frequently asked questions
- How do I install scenario-blender-rigging?
- Run
npx skills add scenario-labs/skills --skill scenario-blender-rigging. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-blender-rigging work with?
- It is written for Zed, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-blender-rigging 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-rigging still maintained?
- The repository was last updated 35 days ago, so scenario-blender-rigging is actively maintained.
Skill content
View source on GitHubname: scenario-blender-rigging description: '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.' license: MIT
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.
Stance (the expert delta)
- Placement is the specification. Joints sit in the center of the volume they move, not on the anatomical skeleton ("bones simulate bone, muscle and tissue"); knees and elbows get a slight pre-bend because the chain's curvature IS the IK plane; rolls put each hinge on one local axis so the animator uses one curve (CGDive; Demeter: the bend, not the roll, decided where his pole landed).
- The metarig is the source, the generated rig is disposable. Every fix goes into metarig bones, Rigify parameters or a post-generation script; regenerating keeps control names, so weights and animation survive (CGDive, Demeter, Ivan Cappiello).
- Automatic weights fail silently.
parent_setreturns 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. - Weights are judged in motion, firm beats mushy. Paint in pose or against a test animation; limit each seam to 2 or 3 bones ("bones fighting for influence"); slight intersection is better than rubbery transitions; rigid parts are assigned at 1.0, never painted (CGDive, Demeter, Dikko).
- Everything that deforms together gets weights from the same source, transferred and applied, so garments cannot drift while animating (Dikko, CGDive).
- Export decides the deformation tools. Four twist bones per segment instead of Preserve Volume; Preserve Volume, Corrective Smooth and B-bones are Blender-only, which is why Rigify segments its DEF bones (CGDive, Ivan).
- The animator is the client. Cut features nobody uses, restrict only what breaks the rig, keep automated bones hand-animatable (constraint plus child, Mix Add, Transformation instead of drivers), stop when fit for purpose (Wayne Dixon, Demeter, CGDive).
- Faces are per-character hybrids. There is no generic stylized face (Demeter); production faces mix joints, ribbons, shape keys and lattices (Rik Schutte).
Establish first
| Input | Changes | Default when silent | | --------------------------------------------- | -------------------------------------------------------------------------------------------------- | ------------------------------------------------------ | | Target: Blender render vs game/FBX | segmented DEF bones, max 4 influences, no Preserve Volume / Corrective Smooth / B-bone deformation | Blender-only keyframe animation | | Character: biped, quadruped, mechanical, prop | metarig preset or custom samples; rigid islands | biped, Rigify | | Face need and style | none / Rigify face / bones + shape keys + on-face controls | body rig + eye and jaw bones only | | Fingers | Rigify Human (fingers + face) vs Basic Human | Basic Human (CGDive: first rig) | | Pose, pieces, scale | T or A pose, separate eyes/teeth/clothes, real scale | measure; fix in the model check | | Animator conventions | FK/IK defaults, side colors, finger controls | legs IK, arms FK, follow 0; left blue, right red (ask) |
Choose the path
| Rigify | Manual / scripted rig |
| -------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ |
| Humans and animals with standard anatomy, many characters sharing controls, fast production-grade result | Unusual anatomy, mechanical parts, strict game-engine hierarchies, rigs that must stay small, or when the brief asks for a custom control scheme |
| add_metarig then fit_metarig, generate | new_bone, twist_chain, fk_ik_switch, ik_chain, foot_roll, make_def_layer, organize |
| Metarig types: arm exactly 3 bones, leg 4 + heel, spine 3+, super_copy 1 bone | DEF / MCH / CTRL: only DEF deforms, MCH is never animated, everything else is a control |
Workflow
- Model check.
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"] == []. - Landmarks.
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 withoverrides={...}. GATE: joint order sane,lm["notes"]empty or explained. - Fit. Rigify:
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 withnew_bonefrom the same landmarks. GATE:R.check_metarig(meta, body) == []ANDR.placement_sheet([body, eyes], out, arm_obj=meta, views=("front","right","top"))looked at; zoom the head withcenter=,size=. - Face (Rigify Human). Fit, then
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). - Generate or build.
rig, err = R.generate(meta);erris 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. - Bind.
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 exportmax_influences=4. - Range of motion.
dr = R.deformation_report(rig, [body, *garments], R.RIGIFY_POSES),R.flag_report(dr), thenR.pose_sheet(...)andR.joint_sheet(...)close-ups and LOOK at them. GATE: no leaks, no unexplained collapse, renders acceptable at armpit, elbow, wrist twist, groin, knee, collar. - Fix, in this order. Placement or roll problems: back to the metarig and regenerate. Weights:
targeted data edits (
strip_opposite_side,assign_rigid,smooth_weightswith 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). - Usability and delivery. Controls visible with In Front off, widgets, side colors, MCH/DEF
hidden, at least one Rigify UI row,
rig_ui.pyneeds Auto Run in a GUI, switches exactly 0 or 1, rest pose clean, test action removed. Report numbers, renders and what was not verified.
Numbers
| Value | Relative to | Source |
| -------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | --------------------- |
| Knee/elbow pre-bend 1 to 3 deg (fit: 1.2% of limb length, 2.7 deg); check 1 to 15 | chain in the bend view | CGDive; check [added] |
| 4 twist bones, Copy Rotation 1.0 / 0.66 / 0.33 / 0.1 (thigh 0.05) | from the driving end | CGDive |
| IK chain length 2; IK Stretch 0.1; lock IK Y/Z on shin and forearm | IK bone | Wayne, CGDive |
| Foot roll: heel X [-90, 0], toe X [0, 90], inside/outside Z one-sided | pivot local, roll 0, pointing up | CGDive (verified) |
| Weight brush Add, strength 0.1 to 0.2, Auto Normalize; seams Mix 0.5 at strength 1 | Weight Paint | CGDive |
| Clean near-zero weights before blurring (Demeter); limit 0.001 (CGDive), 0.01 in bind [added]; 4 influences for games | per vertex | Demeter, CGDive |
| Eyelid follow 0.15 (bone face); Rigify eyelid follow Z 0.3 (default 0.7); jaw bottom lip 0.9; mouth corners follow jaw 0.5 | face | CGDive |
| Palm 0.5 / 0.25; elbow plate 0.2 of forearm rotation | Copy Rotation Local, Mix Add | CGDive |
| Finger curl: Transformation Scale Z 0..1 to Rot Z 90..0 deg, Extrapolate | finger control | CGDive |
| Action constraint: keys frames 1 and 10, LINEAR, max = measured control travel
Truncated for display — read the full file on GitHub.
Related Skills
Agent-Reach
114.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
82.3k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
80.5kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Claude-Code-Game-Studios
40.6kTurn Claude Code into a full game dev studio — 49 AI agents, 75 workflow skills, and a complete coordination system mirroring real studio hierarchy.
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.
