blender-motion-state-inspection

Blender Motion State Inspection is a diagnostic skill for evaluating 3D characters, rigs, poses, and animations inside Blender when a screenshot alone cannot explain what is wrong. Its central principle is that rendered images hide critical facts such as axis conventions, bone names, object scale, local transforms, parented meshes, material slots, and frame-by-frame contact state. Instead of judging an animated asset visually, it first extracts structured scene data and then uses viewport screenshots or renders only to confirm what the measured facts already imply.

The skill provides a repeatable inspection workflow: inventory the scene (meshes, armatures, empties, cameras, lights, modifiers, parent relationships, bounding boxes), identify the skeleton and map semantic bones, determine forward/up/side axes to catch mirrored or backwards imports, sample key animation frames (first, middle, contact, airborne, extreme), and check baseline model integrity before assigning retargeting blame. It then diagnoses specific motion problems -- ground penetration, foot sliding, leg crossover, twist damage, and scale drift -- against numeric thresholds, and returns a report that separates confirmed facts from visual suspicions. Structured extraction is done by running Blender Python inside Blender's own interpreter or via an exporter.

It targets technical animators, riggers, and developers working with imported avatars, motion capture, or retargeted animation who need evidence-based diagnosis rather than guesswork. Typical use cases include debugging a character that skates during a walk cycle, confirming whether an import is mirrored or backwards, and deciding whether a suspicious mesh is a character, prop, proxy, or broken import.