hz-unity-meta-movement-sdk-retargeting
Set up and tweak Meta Movement SDK (MSDK) retargeting for a character model. Use this whenever the user wants to retarget a humanoid FBX/prefab for Meta VR body tracking, generate a retargeting config, or hand-edit the resulting `<asset>.json` (fix known-joint mappings, exclude joints from auto-mapping, rename target joints, adjust per-joint mapping weights, change a mapping behavior to twist/childAlignedTwist, edit T-pose values). The headless entry point is `Meta.XR.Movement.Editor.MSDKUtilityEditor.RunDefaultRetargetingSetup(GameObject asset)` — call it against a live Editor with unity-cli first, then hand-edit if needed. **Skip** if the user is editing runtime retargeting code, the source `OVRSkeletonData.json`, or non-MSDK files.
Install
With your agent
Install OMGSkills skill "meta-quest/agentic-tools:skills/hz-unity-meta-movement-sdk-retargeting" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/meta-quest/agentic-tools /tmp/agentic-tools && ln -s /tmp/agentic-tools/skills/hz-unity-meta-movement-sdk-retargeting ~/.claude/skills/hz-unity-meta-movement-sdk-retargetingFrom README
MSDK Retargeting Config Workflow: always start with the headless API Don't hand-craft the JSON from scratch — the native side computes initial alignment, mappings, and T-pose data that would be tedious to write by hand. The right flow is: Generate the default config by calling Meta.XR.Movement.Editor.MSDKUtilityEditor.RunDefaultRetargetingSetup(GameObject asset, string customDataSourcePath = null) against a live Editor with unity-cli. This is the headless equivalent of clicking through the Retargeting Configuration Editor UI with all defaults (Next×3 → Validate → Done) and produces both artifacts: .json — the retargeting config (this skill targets this file) -metadata.asset — a small ScriptableObject linking the model to the JSON (rarely needs editing) Inspect the generated JSON to verify joint mappings look right. Hand-edit only if needed — the rest of this skill describes the JSON structure and the common tweaks.
More from this repo
hz-android-2d-porting
Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design...
hz-immersive-designer
Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction...
hz-iwsdk-webxr
Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js...