SimReady Conform FET_000_MUJOCO
Purpose
Use this exact feature skill when the selected profile, validation report, or user request names FET_000_MUJOCO. It repairs or stages the MuJoCo physics runtime variant contract on top of neutral Core, without drifting into another runtime contract.
FET_000_MUJOCO adds the MuJoCo runtime variant scaffolding to an asset that already satisfies neutral Core (FET_000_STANDARD@0.1.0). It does not author MuJoCo rigid-body/collider physics itself; that belongs to FET_003_MUJOCO and related features. This skill only makes the MuJoCo variant set, its runnables/physics/mujoco payload, and its SimReady variant metadata correct.
Default to FET_000_MUJOCO@0.1.0 when the user asks for this feature without a version. If the report names a different FET_000_<RUNTIME> feature (FET_000_PHYSX, FET_000_NEWTON), switch to that feature's matching skill before editing.
To conform an asset to a profile like Robotics-Prop@3.1.0 that lists all three optional runtime variants, run all three FET_000_* runtime skills so each of PhysX, Newton, and MuJoCo ends up with both a variant set on the default prim and a SimReady_Metadata.Variants.Physics entry. Never leave a runnables/physics/<stem>.usd payload on disk without its matching variant set and metadata — an orphaned payload fails RV.007/RV.008/RV.009 for its runtime.
This skill is not the final validator and should not silently mutate source assets. It stages a repaired USD-family asset under the requested output directory, applies deterministic fixes only where safe, and stops when a validation gate still fails or a manual decision is required.
Source of Truth
Before changing an asset or package, read:
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_MUJOCO-0.1.0.json
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_MUJOCO.md
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_STANDARD-0.1.0.json (dependency)
- Requirement docs for the failing IDs under
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/requirements/:
mujoco-variant-set.md (RV.007)
mujoco-runtime-payload.md (RV.008)
mujoco-variant-metadata.md (RV.009)
runtime-variant-section-purity.md (RV.010)
runtime-physics-isolation.md (RV.011)
- For the cross-runtime isolation policy that RV.010/RV.011 enforce, read
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/runtime-physics-isolation-matrix.md.
- For the MuJoCo payload body (mesh collision authoring), read
nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/physics_bodies/physics_rigid_bodies/requirements/mujoco-mesh-collision-api.md
and nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_003_MUJOCO.md.
Treat the selected JSON manifest as authoritative for dependencies and requirement IDs.
This skill is self-contained: the deterministic guidance and worked example below are sufficient to author a conforming MuJoCo runtime variant from scratch. You do not need to open an existing 3.1.0 asset and copy its structure — do so only to cross-check, and only against a sample known to pass.
Sample-asset caveats (do not copy structure blindly):
- Author from the requirement docs and the worked example below, not by copying an existing asset. Sample assets drift, and a stale or pre-contract sample will lead you astray. If you do cross-check, only trust a sample you have just confirmed passes the full target profile (RV.001–011 and AA.001, not the RV-only harness) — never treat any specific asset as a canonical template.
Feature Versions
Inputs
| Input |
Requirement |
usd_asset |
Required USD-family asset to repair. |
output_root |
Required or inferred folder for staged assets and reports. |
simready_profile / profile_version |
Validation target, if supplied. |
validation_report |
Preferred JSON/markdown report from the failing gate. |
mujoco_overrides |
Optional source of the MuJoCo runtime override data (schemas/attributes) to place in the payload; required to fully author mujoco.usd content. |
Workflow
- Confirm the input exists and identify the exact selected feature/version.
- Ensure the neutral Core gate (
FET_000_STANDARD@0.1.0) is in shape first; if Core fails, hand off to simready-foundation-conform-fet-000-standard before this skill.
- Load the
FET_000_MUJOCO manifest, the feature markdown, and the RV.007-RV.009 + RV.010/RV.011 requirement docs (plus the isolation matrix).
- Create or use a staged output location unless the user explicitly asks for in-place edits.
- Repair only
RV.007, RV.008, RV.009, RV.010, and RV.011 (see Feature Guidance). Do not touch PhysX/Newton variants or rigid-body physics.
- Rerun the same profile gate or the narrowest available feature/capability validation gate.
- Summarize the selected version, changed files, validation evidence, and the first remaining blocker or next exact feature gate.
Feature Guidance
Repair each MuJoCo runtime variant requirement deterministically where safe:
RV.007 (variant set): On the stage defaultPrim, add a MuJoCo variant set with Disabled and Enabled options and author the default selection as Disabled. Keep the Disabled variant free of runtime payloads.
RV.008 (payload): From the Enabled variant, prepend payload = @./runnables/physics/mujoco.usd@ (or .usda). The payload must live inside the asset root — the directory that holds the root layer — so keep runnables/physics/ as a subfolder beside the root layer and anchor the arc with ./. Do not place runnables/ beside or above the asset root and reference it with @../runnables/physics/mujoco.usd@: a ../ payload that resolves above the asset root fails AA.001 (atomic-asset anchored paths) and precludes FET_001_STANDARD, even though the RV.008 payload check alone still passes — so the RV-only local harness will not catch it. Create the runnables/physics/mujoco.usd layer as an over layer with the same defaultPrim. .usd and .usda are interchangeable; author .usda when a binary USDC cannot be compiled.
RV.009 (metadata): Add customLayerData.SimReady_Metadata.Variants.Physics.MuJoCo = {prim = <defaultPrim path>, variantSetName = "MuJoCo", activateOption = "Enabled"}. The Variants dict must live inside SimReady_Metadata, not as a sibling top-level customLayerData.Variants key.
RV.010 (variant-section purity): Keep the variant sections pure. The Enabled option must contain only the prepend payload arc — no inline over/def child prims, no authored properties, no other composition arcs. The Disabled option must be completely empty. Inline variant opinions outrank payloads in USD strength ordering (LIVRPS), so any override authored in a variant section leaks into the composed result of the other runtimes. All runtime data belongs in the runnables/physics/mujoco.usd payload, never in the root variant edit.
RV.011 (composed-stage isolation): The composed MuJoCo stage (MuJoCo Enabled, others Disabled) must carry only neutral UsdPhysics/physics:* data plus MuJoCo data (Mjc* schemas, mjc:* attributes). The inherited Newton collision base (NewtonCollisionAPI, newton:contactGap/newton:contactMargin) is the only Newton data allowed, via MjcCollisionAPI's upstream inheritance; do not author any other Newton*/newton:*. Do not author PhysX (Physx*/physx*:) data. On a MjcCollisionAPI mesh, physics:approximation must be convexHull (MUJOCO.COL.002) — never sdf or convexDecomposition. RV.010/RV.011 are composition-wide checks: if a sibling runtime's section is impure or its payload leaks a foreign schema, report it rather than silently editing another runtime's contract.
- Neutral-base precondition (RV.011 / MUJOCO.COL.002). MuJoCo requires
physics:approximation = "convexHull" on the collider, and the mujoco.usd over sets it. For that over to win, the neutral base collider must not author physics:approximation as a local (non-variant) opinion. A local base opinion outranks the payload arc in USD strength ordering (LIVRPS: Local > … > Payload), so a base convexDecomposition/sdf masks the required convexHull and fails MUJOCO.COL.002 under the MuJoCo selection (and leaks into the other runtimes). If the neutral base authors physics:approximation, clear that local opinion so each runnable owns its own value (PhysX sdf, MuJoCo convexHull, Newton none). See the "Value-level attribute rules" in the isolation matrix.
- Migrating a runtime-authored base (RV.011). If the asset arrives with a different runtime authored directly on the neutral base — common when a prop was previously conformed to a single-runtime PhysX profile — the base collider carries that runtime's API schemas (e.g.
PhysxCollisionAPI, PhysxSDFMeshCollisionAPI) alongside PhysicsMeshCollisionAPI and a local physics:approximation. Move that runtime data into its own runnable payload and reduce the neutral base collider to neutral UsdPhysics only (PhysicsCollisionAPI + PhysicsMassAPI), with the mesh-collision schema and approximation living in the per-runtime payloads. Otherwise the neutral (all-Disabled) composition still carries foreign runtime schemas and fails RV.011.
MuJoCo payload body for a single-mesh prop
For a simple prop whose collision is a single existing mesh, the mujoco.usd payload body is a deterministic mesh-collision delta. Apply on the collision mesh over:
prepend apiSchemas = ["MjcCollisionAPI", "PhysicsMeshCollisionAPI", "MjcMeshCollisionAPI"]
uniform token physics:approximation = "convexHull" (required when PhysicsMeshCollisionAPI + MjcCollisionAPI are combined)
uniform int mjc:group = 2
uniform token mjc:inertia = "convex" (one of legacy, convex, exact, shell)
uniform int mjc:maxhullvert = -1 (>= -1; -1 means no limit)
Do not create geometry; only add schemas/attributes to the mesh(es) that already exist in the neutral base.
Block and report instead of guessing when:
- The asset needs MuJoCo joints, actuators, or scene/material tuning, or per-link collider decisions that are not the uniform delta below. Author the variant/payload scaffolding and hand that body work off to
FET_003_MUJOCO/FET_004_MUJOCO/FET_022_MUJOCO or the supplied mujoco_overrides. A plain multibody prop whose colliders all take the same delta is in scope — see "Multibody / multi-collider assemblies" below.
- The collision geometry or intended collider mesh is ambiguous.
- The asset has no
defaultPrim, or the intended owning prim is ambiguous.
Keep joint/articulation/actuator MuJoCo physics work in FET_003_MUJOCO/FET_004_MUJOCO; this skill owns the runtime variant scaffolding plus the collision delta — one collider mesh for a single-mesh prop, or every collider mesh for a multibody assembly (below).
Multibody / multi-collider assemblies
When the neutral base is a multibody assembly — several rigid-body parts sharing one articulation (e.g. a toolbox with a hinged lid, handle, and locks) — the mujoco.usd payload is the same collision delta applied to every collider:
- Apply the mesh-collision
over above (MjcCollisionAPI, PhysicsMeshCollisionAPI, MjcMeshCollisionAPI + physics:approximation = "convexHull" + mjc:group/mjc:inertia/mjc:maxhullvert) to each collider mesh in the assembly.
- Keep the payload collider-only: never re-author joints, articulation, actuators, or rigid bodies in
mujoco.usd — that topology lives once on the neutral base.
Neutral-base preconditions for a multibody assembly (owned by FET_004_STANDARD/FET_004_MUJOCO, repair there — not here):
- Every collider mesh must have its local
physics:approximation cleared, so each runnable owns its own value (the convexHull above must win from the payload — MUJOCO.COL.002).
- The base carries the runtime-agnostic multibody topology (rigid bodies +
UsdPhysics joints) and exactly one PhysicsArticulationRootAPI. If the topology or articulation root is missing, hand off to FET_004_STANDARD/FET_004_MUJOCO before wiring the MuJoCo variant.
Worked Example: single-mesh prop
Add the MuJoCo variant to a single-mesh prop in four edits (illustrated with a RootNode-rooted prop; substitute your asset's defaultPrim and collider mesh path). This is authored from the requirement docs — it does not depend on any existing asset.
- Create the payload layer
runnables/physics/mujoco.usd inside the asset root, in a runnables/physics/ subfolder beside the root layer (e.g. simready_usd/runnables/physics/mujoco.usd), with the same defaultPrim as the root asset. Do not place runnables/ outside the asset root — the ./-anchored payload below must resolve within it (AA.001). Standardize on binary .usd; author the equivalent .usda below and export it to .usd (e.g. Sdf.Layer.FindOrOpen("mujoco.usda").Export("mujoco.usd")), or keep .usda if a binary cannot be compiled:
#usda 1.0
(
defaultPrim = "RootNode"
doc = """MuJoCo overrides for sm_obs_orange_a02_01.usda"""
)
over "RootNode"
{
over "Geometry"
{
over "obs_orange_01_obj_01"
{
over "obs_orange_01_mesh_01" (
prepend apiSchemas = ["MjcCollisionAPI", "PhysicsMeshCollisionAPI", "MjcMeshCollisionAPI"]
)
{
uniform token physics:approximation = "convexHull"
uniform int mjc:group = 2
uniform token mjc:inertia = "convex"
uniform int mjc:maxhullvert = -1
}
}
}
}
- In the root asset layer, add the
MuJoCo entry to customLayerData.SimReady_Metadata.Variants.Physics (alongside any PhysX/Newton entries). The Variants dict lives inside SimReady_Metadata, never as a sibling top-level customLayerData.Variants key:
"MuJoCo" = {
string prim = "/RootNode"
string variantSetName = "MuJoCo"
string activateOption = "Enabled"
}
On RootNode, add "MuJoCo" to prepend variantSets and add its default selection to variants (string MuJoCo = "Disabled").
Add the variantSet "MuJoCo" block with a payload-free Disabled option and an Enabled option that prepends the payload:
variantSet "MuJoCo" = {
"Disabled" {
}
"Enabled" (
prepend payload = @./runnables/physics/mujoco.usd@
) {
}
}
Note that the Enabled option holds only the payload arc and the Disabled option is empty (RV.010), and the payload authors only MuJoCo + neutral data with physics:approximation = "convexHull" (RV.011).
Validation
The RV.007-RV.009 + RV.010/RV.011 checks live in nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/validation.py and are generated into simready.foundation.tier_core.requirements as RV_001-RV_011. To run them locally:
- Build the core tier wheel, which is what generates the
RV_001-RV_011 enums from the capability markdown: repo.bat build_tiers (writes nv_core/tiers/simready_foundation_tier_core/_build/dist/simready_foundation_tier_core-*.whl).
- Create a Python 3.12 venv:
repo.bat uv venv --python 3.12 .venv_val.
- Install USD, the validator deps, and the tier wheel into it:
repo.bat uv pip install --python .venv_val usd-core usd-validation-nvidia numpy nv_core/tiers/simready_foundation_tier_core/_build/dist/simready_foundation_tier_core-*.whl.
- Invoke the venv Python directly (not
uv run, which spawns its own venv) against a small harness that imports simready.foundation.tier_core.capabilities.core.runtime_variants.validation, calls ResetCaches() then CheckStage(stage) on each checker, and reads results via checker.GetIssues(). Installing the wheel puts the generated enums on the path, so no PYTHONPATH setup is needed.
Confirm the MuJoCo trio (RV_007/RV_008/RV_009) plus the isolation rules (RV_010/RV_011) pass on the Disabled-default stage. RV.011 recomposes each declared variant selection, so also spot-check that enabling MuJoCo composes only MuJoCo + neutral physics with physics:approximation = "convexHull". If the environment cannot be bootstrapped, fall back to inspecting the staged USD for the variant set, anchored payload, nested SimReady_Metadata.Variants.Physics.MuJoCo entry, pure variant sections, and a MuJoCo-only payload, and report validation as inspection-only.
Limitations
- Do not silently mutate the source asset; work on the requested staged output.
- Do not author PhysX or Newton variants in this skill.
- Keep runtime data out of the root variant sections (RV.010) and keep the MuJoCo payload free of PhysX schemas/attributes; use
physics:approximation = "convexHull", never sdf/convexDecomposition (RV.011).
- Do not create geometry; the single-mesh collision delta only annotates existing meshes.
- Beyond the deterministic single-mesh convexHull delta, do not invent MuJoCo runtime physics values (joints, actuators, scene/material tuning) that require domain knowledge; scaffold and hand off to
FET_003_MUJOCO/FET_004_MUJOCO/FET_022_MUJOCO.
Report Fields
| Field |
Meaning |
feature |
Exact feature ID and version, for example FET_000_MUJOCO@0.1.0. |
input |
Source asset or package inspected. |
output |
Staged output path, or in-place only when explicitly requested. |
requirements_repaired |
Requirement IDs repaired in this pass (subset of RV.007-RV.009, RV.010, RV.011). |
requirements_blocked |
Requirement IDs needing MuJoCo override data or user input. |
validation |
Command or inspection used to verify this exact feature. |
status |
passed, failed, skipped, or blocked. |
next_step |
The next exact feature skill or evidence needed. |
1---2name: simready-foundation-conform-fet-000-mujoco3description: "Use for repairing exact FET_000_MUJOCO SimReady conformance: the MuJoCo physics runtime variant scaffolding (MuJoCo variant set, runnables/physics/mujoco payload, and SimReady variant metadata). Use when a profile, validation report, or user request names FET_000_MUJOCO; default to version `0.1.0`."4license: Apache-2.05metadata:6 source: https://skillmd.com/skills/nvidia/simready-foundation-conform-fet-000-mujoco7 author: "Shaad Boochoon <sboochoon@nvidia.com>"8 tags:9 - simready10 - conformance11 - mujoco12 - core13---1415# SimReady Conform FET_000_MUJOCO1617## Purpose1819Use this exact feature skill when the selected profile, validation report, or user request names `FET_000_MUJOCO`. It repairs or stages the MuJoCo physics runtime variant contract on top of neutral Core, without drifting into another runtime contract.2021`FET_000_MUJOCO` adds the MuJoCo runtime variant scaffolding to an asset that already satisfies neutral Core (`FET_000_STANDARD@0.1.0`). It does not author MuJoCo rigid-body/collider physics itself; that belongs to `FET_003_MUJOCO` and related features. This skill only makes the `MuJoCo` variant set, its `runnables/physics/mujoco` payload, and its SimReady variant metadata correct.2223Default to `FET_000_MUJOCO@0.1.0` when the user asks for this feature without a version. If the report names a different `FET_000_<RUNTIME>` feature (`FET_000_PHYSX`, `FET_000_NEWTON`), switch to that feature's matching skill before editing.2425To conform an asset to a profile like `Robotics-Prop@3.1.0` that lists all three optional runtime variants, run all three `FET_000_*` runtime skills so each of `PhysX`, `Newton`, and `MuJoCo` ends up with **both** a variant set on the default prim **and** a `SimReady_Metadata.Variants.Physics` entry. Never leave a `runnables/physics/<stem>.usd` payload on disk without its matching variant set and metadata — an orphaned payload fails `RV.007`/`RV.008`/`RV.009` for its runtime.2627This skill is not the final validator and should not silently mutate source assets. It stages a repaired USD-family asset under the requested output directory, applies deterministic fixes only where safe, and stops when a validation gate still fails or a manual decision is required.2829## Source of Truth3031Before changing an asset or package, read:3233- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_MUJOCO-0.1.0.json`34- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_MUJOCO.md`35- `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_STANDARD-0.1.0.json` (dependency)36- Requirement docs for the failing IDs under `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/requirements/`:37 - `mujoco-variant-set.md` (RV.007)38 - `mujoco-runtime-payload.md` (RV.008)39 - `mujoco-variant-metadata.md` (RV.009)40 - `runtime-variant-section-purity.md` (RV.010)41 - `runtime-physics-isolation.md` (RV.011)42- For the cross-runtime isolation policy that RV.010/RV.011 enforce, read43 `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/runtime-physics-isolation-matrix.md`.44- For the MuJoCo payload body (mesh collision authoring), read45 `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/physics_bodies/physics_rigid_bodies/requirements/mujoco-mesh-collision-api.md`46 and `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_003_MUJOCO.md`.4748Treat the selected JSON manifest as authoritative for dependencies and requirement IDs.4950This skill is **self-contained**: the deterministic guidance and worked example below are sufficient to author a conforming `MuJoCo` runtime variant from scratch. You do not need to open an existing 3.1.0 asset and copy its structure — do so only to cross-check, and only against a sample known to pass.5152Sample-asset caveats (do not copy structure blindly):5354- Author from the requirement docs and the worked example below, not by copying an existing asset. Sample assets drift, and a stale or pre-contract sample will lead you astray. If you do cross-check, only trust a sample you have **just** confirmed passes the full target profile (RV.001–011 **and** AA.001, not the RV-only harness) — never treat any specific asset as a canonical template.5556## Feature Versions5758| Version | Dependencies | Requirements |59|---|---|---|60| `0.1.0` | FET_000_STANDARD@0.1.0 | `RV.007`, `RV.008`, `RV.009`, `RV.010`, `RV.011` |6162## Inputs6364| Input | Requirement |65|---|---|66| `usd_asset` | Required USD-family asset to repair. |67| `output_root` | Required or inferred folder for staged assets and reports. |68| `simready_profile` / `profile_version` | Validation target, if supplied. |69| `validation_report` | Preferred JSON/markdown report from the failing gate. |70| `mujoco_overrides` | Optional source of the MuJoCo runtime override data (schemas/attributes) to place in the payload; required to fully author `mujoco.usd` content. |7172## Workflow73741. Confirm the input exists and identify the exact selected feature/version.752. Ensure the neutral Core gate (`FET_000_STANDARD@0.1.0`) is in shape first; if Core fails, hand off to `simready-foundation-conform-fet-000-standard` before this skill.763. Load the `FET_000_MUJOCO` manifest, the feature markdown, and the RV.007-RV.009 + RV.010/RV.011 requirement docs (plus the isolation matrix).774. Create or use a staged output location unless the user explicitly asks for in-place edits.785. Repair only `RV.007`, `RV.008`, `RV.009`, `RV.010`, and `RV.011` (see Feature Guidance). Do not touch PhysX/Newton variants or rigid-body physics.796. Rerun the same profile gate or the narrowest available feature/capability validation gate.807. Summarize the selected version, changed files, validation evidence, and the first remaining blocker or next exact feature gate.8182## Feature Guidance8384Repair each MuJoCo runtime variant requirement deterministically where safe:8586- `RV.007` (variant set): On the stage `defaultPrim`, add a `MuJoCo` variant set with `Disabled` and `Enabled` options and author the default selection as `Disabled`. Keep the `Disabled` variant free of runtime payloads.87- `RV.008` (payload): From the `Enabled` variant, `prepend payload = @./runnables/physics/mujoco.usd@` (or `.usda`). The payload must live **inside the asset root** — the directory that holds the root layer — so keep `runnables/physics/` as a subfolder beside the root layer and anchor the arc with `./`. Do **not** place `runnables/` beside or above the asset root and reference it with `@../runnables/physics/mujoco.usd@`: a `../` payload that resolves above the asset root fails **AA.001** (atomic-asset anchored paths) and precludes `FET_001_STANDARD`, even though the RV.008 payload check alone still passes — so the RV-only local harness will not catch it. Create the `runnables/physics/mujoco.usd` layer as an `over` layer with the same `defaultPrim`. `.usd` and `.usda` are interchangeable; author `.usda` when a binary USDC cannot be compiled.88- `RV.009` (metadata): Add `customLayerData.SimReady_Metadata.Variants.Physics.MuJoCo = {prim = <defaultPrim path>, variantSetName = "MuJoCo", activateOption = "Enabled"}`. The `Variants` dict must live **inside** `SimReady_Metadata`, not as a sibling top-level `customLayerData.Variants` key.89- `RV.010` (variant-section purity): Keep the variant sections pure. The `Enabled` option must contain **only** the `prepend payload` arc — no inline `over`/`def` child prims, no authored properties, no other composition arcs. The `Disabled` option must be **completely empty**. Inline variant opinions outrank payloads in USD strength ordering (LIVRPS), so any override authored in a variant section leaks into the composed result of the *other* runtimes. All runtime data belongs in the `runnables/physics/mujoco.usd` payload, never in the root variant edit.90- `RV.011` (composed-stage isolation): The composed MuJoCo stage (MuJoCo `Enabled`, others `Disabled`) must carry only neutral `UsdPhysics`/`physics:*` data plus MuJoCo data (`Mjc*` schemas, `mjc:*` attributes). The inherited Newton collision base (`NewtonCollisionAPI`, `newton:contactGap`/`newton:contactMargin`) is the only Newton data allowed, via `MjcCollisionAPI`'s upstream inheritance; do not author any other `Newton*`/`newton:*`. Do not author PhysX (`Physx*`/`physx*:`) data. On a `MjcCollisionAPI` mesh, `physics:approximation` must be `convexHull` (MUJOCO.COL.002) — never `sdf` or `convexDecomposition`. RV.010/RV.011 are composition-wide checks: if a sibling runtime's section is impure or its payload leaks a foreign schema, report it rather than silently editing another runtime's contract.91- **Neutral-base precondition (RV.011 / MUJOCO.COL.002).** MuJoCo requires `physics:approximation = "convexHull"` on the collider, and the `mujoco.usd` `over` sets it. For that `over` to win, the neutral base collider must **not** author `physics:approximation` as a local (non-variant) opinion. A local base opinion outranks the payload arc in USD strength ordering (LIVRPS: Local > … > Payload), so a base `convexDecomposition`/`sdf` masks the required `convexHull` and fails MUJOCO.COL.002 under the MuJoCo selection (and leaks into the other runtimes). If the neutral base authors `physics:approximation`, clear that local opinion so each runnable owns its own value (PhysX `sdf`, MuJoCo `convexHull`, Newton none). See the "Value-level attribute rules" in the isolation matrix.92- **Migrating a runtime-authored base (RV.011).** If the asset arrives with a different runtime authored directly on the neutral base — common when a prop was previously conformed to a single-runtime PhysX profile — the base collider carries that runtime's API schemas (e.g. `PhysxCollisionAPI`, `PhysxSDFMeshCollisionAPI`) alongside `PhysicsMeshCollisionAPI` and a local `physics:approximation`. Move that runtime data into its own runnable payload and reduce the neutral base collider to neutral `UsdPhysics` only (`PhysicsCollisionAPI` + `PhysicsMassAPI`), with the mesh-collision schema and approximation living in the per-runtime payloads. Otherwise the neutral (all-`Disabled`) composition still carries foreign runtime schemas and fails RV.011.9394### MuJoCo payload body for a single-mesh prop9596For a simple prop whose collision is a single existing mesh, the `mujoco.usd` payload body is a deterministic mesh-collision delta. Apply on the collision mesh `over`:9798- `prepend apiSchemas = ["MjcCollisionAPI", "PhysicsMeshCollisionAPI", "MjcMeshCollisionAPI"]`99- `uniform token physics:approximation = "convexHull"` (required when `PhysicsMeshCollisionAPI` + `MjcCollisionAPI` are combined)100- `uniform int mjc:group = 2`101- `uniform token mjc:inertia = "convex"` (one of `legacy`, `convex`, `exact`, `shell`)102- `uniform int mjc:maxhullvert = -1` (>= -1; -1 means no limit)103104Do not create geometry; only add schemas/attributes to the mesh(es) that already exist in the neutral base.105106Block and report instead of guessing when:107108- The asset needs MuJoCo joints, actuators, or scene/material tuning, or per-link collider decisions that are not the uniform delta below. Author the variant/payload scaffolding and hand that body work off to `FET_003_MUJOCO`/`FET_004_MUJOCO`/`FET_022_MUJOCO` or the supplied `mujoco_overrides`. A plain multibody prop whose colliders all take the same delta is in scope — see "Multibody / multi-collider assemblies" below.109- The collision geometry or intended collider mesh is ambiguous.110- The asset has no `defaultPrim`, or the intended owning prim is ambiguous.111112Keep joint/articulation/actuator MuJoCo physics work in `FET_003_MUJOCO`/`FET_004_MUJOCO`; this skill owns the runtime variant scaffolding plus the collision delta — one collider mesh for a single-mesh prop, or every collider mesh for a multibody assembly (below).113114### Multibody / multi-collider assemblies115116When the neutral base is a multibody assembly — several rigid-body parts sharing one articulation (e.g. a toolbox with a hinged lid, handle, and locks) — the `mujoco.usd` payload is the same collision delta applied to **every** collider:117118- Apply the mesh-collision `over` above (`MjcCollisionAPI`, `PhysicsMeshCollisionAPI`, `MjcMeshCollisionAPI` + `physics:approximation = "convexHull"` + `mjc:group`/`mjc:inertia`/`mjc:maxhullvert`) to **each** collider mesh in the assembly.119- Keep the payload collider-only: never re-author joints, articulation, actuators, or rigid bodies in `mujoco.usd` — that topology lives once on the neutral base.120121Neutral-base preconditions for a multibody assembly (owned by `FET_004_STANDARD`/`FET_004_MUJOCO`, repair there — not here):122123- **Every** collider mesh must have its local `physics:approximation` cleared, so each runnable owns its own value (the `convexHull` above must win from the payload — MUJOCO.COL.002).124- The base carries the runtime-agnostic multibody topology (rigid bodies + `UsdPhysics` joints) and exactly one `PhysicsArticulationRootAPI`. If the topology or articulation root is missing, hand off to `FET_004_STANDARD`/`FET_004_MUJOCO` before wiring the MuJoCo variant.125126## Worked Example: single-mesh prop127128Add the `MuJoCo` variant to a single-mesh prop in four edits (illustrated with a `RootNode`-rooted prop; substitute your asset's `defaultPrim` and collider mesh path). This is authored from the requirement docs — it does not depend on any existing asset.1291301. Create the payload layer `runnables/physics/mujoco.usd` **inside the asset root**, in a `runnables/physics/` subfolder beside the root layer (e.g. `simready_usd/runnables/physics/mujoco.usd`), with the same `defaultPrim` as the root asset. Do not place `runnables/` outside the asset root — the `./`-anchored payload below must resolve within it (AA.001). Standardize on binary `.usd`; author the equivalent `.usda` below and export it to `.usd` (e.g. `Sdf.Layer.FindOrOpen("mujoco.usda").Export("mujoco.usd")`), or keep `.usda` if a binary cannot be compiled:131132```usd133#usda 1.0134(135 defaultPrim = "RootNode"136 doc = """MuJoCo overrides for sm_obs_orange_a02_01.usda"""137)138139over "RootNode"140{141 over "Geometry"142 {143 over "obs_orange_01_obj_01"144 {145 over "obs_orange_01_mesh_01" (146 prepend apiSchemas = ["MjcCollisionAPI", "PhysicsMeshCollisionAPI", "MjcMeshCollisionAPI"]147 )148 {149 uniform token physics:approximation = "convexHull"150 uniform int mjc:group = 2151 uniform token mjc:inertia = "convex"152 uniform int mjc:maxhullvert = -1153 }154 }155 }156}157```1581592. In the root asset layer, add the `MuJoCo` entry to `customLayerData.SimReady_Metadata.Variants.Physics` (alongside any `PhysX`/`Newton` entries). The `Variants` dict lives **inside** `SimReady_Metadata`, never as a sibling top-level `customLayerData.Variants` key:160161```usd162"MuJoCo" = {163 string prim = "/RootNode"164 string variantSetName = "MuJoCo"165 string activateOption = "Enabled"166}167```1681693. On `RootNode`, add `"MuJoCo"` to `prepend variantSets` and add its default selection to `variants` (`string MuJoCo = "Disabled"`).1701714. Add the `variantSet "MuJoCo"` block with a payload-free `Disabled` option and an `Enabled` option that prepends the payload:172173```usd174variantSet "MuJoCo" = {175 "Disabled" {176 }177 "Enabled" (178 prepend payload = @./runnables/physics/mujoco.usd@179 ) {180 }181}182```183184Note that the `Enabled` option holds only the payload arc and the `Disabled` option is empty (RV.010), and the payload authors only MuJoCo + neutral data with `physics:approximation = "convexHull"` (RV.011).185186## Validation187188The RV.007-RV.009 + RV.010/RV.011 checks live in `nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/validation.py` and are generated into `simready.foundation.tier_core.requirements` as `RV_001`-`RV_011`. To run them locally:1891901. Build the core tier wheel, which is what generates the `RV_001`-`RV_011` enums from the capability markdown: `repo.bat build_tiers` (writes `nv_core/tiers/simready_foundation_tier_core/_build/dist/simready_foundation_tier_core-*.whl`).1912. Create a Python 3.12 venv: `repo.bat uv venv --python 3.12 .venv_val`.1923. Install USD, the validator deps, and the tier wheel into it: `repo.bat uv pip install --python .venv_val usd-core usd-validation-nvidia numpy nv_core/tiers/simready_foundation_tier_core/_build/dist/simready_foundation_tier_core-*.whl`.1934. Invoke the venv Python directly (not `uv run`, which spawns its own venv) against a small harness that imports `simready.foundation.tier_core.capabilities.core.runtime_variants.validation`, calls `ResetCaches()` then `CheckStage(stage)` on each checker, and reads results via `checker.GetIssues()`. Installing the wheel puts the generated enums on the path, so no `PYTHONPATH` setup is needed.194195Confirm the MuJoCo trio (`RV_007`/`RV_008`/`RV_009`) plus the isolation rules (`RV_010`/`RV_011`) pass on the `Disabled`-default stage. RV.011 recomposes each declared variant selection, so also spot-check that enabling MuJoCo composes only MuJoCo + neutral physics with `physics:approximation = "convexHull"`. If the environment cannot be bootstrapped, fall back to inspecting the staged USD for the variant set, anchored payload, nested `SimReady_Metadata.Variants.Physics.MuJoCo` entry, pure variant sections, and a MuJoCo-only payload, and report validation as inspection-only.196197## Limitations198199- Do not silently mutate the source asset; work on the requested staged output.200- Do not author PhysX or Newton variants in this skill.201- Keep runtime data out of the root variant sections (RV.010) and keep the MuJoCo payload free of PhysX schemas/attributes; use `physics:approximation = "convexHull"`, never `sdf`/`convexDecomposition` (RV.011).202- Do not create geometry; the single-mesh collision delta only annotates existing meshes.203- Beyond the deterministic single-mesh convexHull delta, do not invent MuJoCo runtime physics values (joints, actuators, scene/material tuning) that require domain knowledge; scaffold and hand off to `FET_003_MUJOCO`/`FET_004_MUJOCO`/`FET_022_MUJOCO`.204205## Report Fields206207| Field | Meaning |208|---|---|209| `feature` | Exact feature ID and version, for example `FET_000_MUJOCO@0.1.0`. |210| `input` | Source asset or package inspected. |211| `output` | Staged output path, or `in-place` only when explicitly requested. |212| `requirements_repaired` | Requirement IDs repaired in this pass (subset of RV.007-RV.009, RV.010, RV.011). |213| `requirements_blocked` | Requirement IDs needing MuJoCo override data or user input. |214| `validation` | Command or inspection used to verify this exact feature. |215| `status` | `passed`, `failed`, `skipped`, or `blocked`. |216| `next_step` | The next exact feature skill or evidence needed. |