blender-motion-state-inspection

Extract structured Blender scene data to validate character motion against expected poses.

Updated Apr 13, 2026
One-click install
npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill blender-motion-state-inspection
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: blender-motion-state-inspection
Source: https://github.com/sakamoto-family-smile/agent_monorepo/tree/main/.claude/skills/ecc/blender-motion-state-inspection
Command: npx skills add https://github.com/sakamoto-family-smile/agent_monorepo --skill blender-motion-state-inspection

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Blender motion state inspection compiles and analyzes structured scene data (meshes, armatures, bones, and motion) to verify that animated characters align with expected poses, rather than relying on screenshots alone.

Core Features & Use Cases

  • Extracts scene inventory (meshes, armatures, cameras, lights) and captures bone mappings, poses, and root motion.
  • Detects common motion issues such as twisting, mirroring, foot sliding, and scale drift, providing actionable insights for retargeting and animation fixes.
  • Use Case: validate that a retargeted walk cycle aligns with a target pose across frames and generate a report highlighting discrepancies.

Quick Start

Run the Blender motion state inspection workflow on your scene to generate a structured report of bone states, contacts, and root motion.

Frequently Asked Questions about blender-motion-state-inspection

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect foot sliding and bone twisting in Blender animations?

Blender motion inspection detects foot sliding and bone twisting by extracting armature and bone state data for frame-by-frame validation against expected poses, outputting a structured report of motion discrepancies.

Can I validate a retargeted walk cycle frame by frame in Blender?

Yes, retargeted walk cycles are validated by capturing bone mappings, poses, and root motion across sampled frames to verify the animated character aligns with the target pose and highlighting discrepancies in a report.

How does Blender motion inspection diagnose mirrored character poses?

Motion inspection diagnoses mirrored poses by compiling structured scene inventory and bone mappings, rigorously analyzing sampled frames to verify alignment with expected poses rather than relying on screenshots alone.

Do I need bpy-based tooling to extract armature and bone state for animation validation?

Yes, bpy-based tooling is required to collect meshes, armatures, bones, bounding boxes, contacts, and sampled frames from your Blender scene to perform structured motion state validation.

What is the best way to check for scale drift in a Blender rigged character?

The best way to check for scale drift is running a motion state inspection that extracts bone states and root motion across frames, validating the rigged character against expected poses to produce actionable insights.