# hz-unity-meta-movement-sdk-retargeting

> Claude/Codex skill by [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars · Updated 2026-09-24

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.

Tags: adb, agent-skills, cli, dev-tools, horizon-os, mcp, mcp-server, meta, meta-quest, mixed-reality, model-context-protocol, quest, skills, vr

## Install

```sh
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-retargeting
```

## From 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.

## Links

- HTML page: https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-unity-meta-movement-sdk-retargeting/
- GitHub: https://github.com/meta-quest/agentic-tools
- Author: [@meta-quest](https://omgskills.com/library/meta-quest/index.md)

## More from this repo

- [hz-android-2d-porting](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-android-2d-porting/index.md) — Guides porting existing Android 2D apps to Meta VR and Horizon OS — input adaptation, panel layout, and design...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-immersive-designer](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-immersive-designer/index.md) — Guides design of comfortable, intuitive VR/MR experiences for Meta VR and Horizon OS — comfort guidelines, interaction...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars
- [hz-iwsdk-webxr](https://omgskills.com/library/meta-quest/agentic-tools/skills/hz-iwsdk-webxr/index.md) — Builds WebXR experiences for Meta VR and Horizon OS using the Immersive Web SDK (IWSDK) — ECS architecture, Three.js...
   - [@meta-quest](https://omgskills.com/library/meta-quest/index.md) · 231 stars