Blender VRM Visible Fit
Use this skill for manual-in-the-loop Blender avatar fitting where the user must see each change before export.
Workflow
- Open Blender in foreground with exactly one clean scene file.
- Import base VRM and verify full body continuity before any edits.
- Import clothing asset VRM/mesh and isolate only required materials (dress, shoes).
- Align clothing in viewport with user-visible checkpoints.
- Transfer/bind weights with robust transfer tools.
- Run pose stress checks (hips, knees, elbows, shoulders, ankles).
- Export Blender-pass VRM only after user approval.
- Record build evidence JSON and screenshots.
Hard Rules
- Never run hidden background rebuilds for fit-critical edits.
- Never delete base body geometry before user fit approval.
- Never use global hole-fill on body meshes.
- Keep shoes as an independent mesh lane unless the source requires merge.
Commands
Checkpoint snapshot:
python3 scripts/checkpoint_state.py \
--scene /path/to/scene.blend \
--stage "after_weight_transfer" \
--json-out /tmp/blender-vrm-checkpoint.json
References
references/visible-fit-checklist.mdreferences/open-source-tooling.md
Loopback
If fit/rig quality is uncertain:
- Stop export.
- Capture current checkpoint JSON + screenshots.
- Return to stage
alignorweight_transferand continue visibly.