agentleFS
NVIDIAKnown publisherNVIDIA/simready-foundation/.agents/skills/simready-foundation-conform-fet-000-standard/SKILL.md

simready-foundation-conform-fet-000-standard

Skill156 starsChanged 54 days agoApache-2.0View on GitHub

Use for repairing FET_000_STANDARD Core failures (default `0.2.0`; use `0.1.0` when a profile pins it): asset file naming, directory layout, relative and resolvable paths, SimReady metadata, and undefined prims.

The file

Show its rules and text

We split this skill into the rules it gives an agent

15 rules. About 0 are common, 8 are distinctive, and 7 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈8

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 7

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Use this workflow skill to bring an existing USD asset into conformance with the selected FET_000_STANDARD Core feature contract, then hand …

    line 17
  2. Very specific:

    Default to FET_000_STANDARD@0.2.0 when the user asks for this feature without a version.

    line 19
  3. Distinctive:

    Read the source-of-truth files named below before editing.

    line 27
  4. Very specific:

    Before changing an asset, load the exact FET_000_STANDARD manifest selected by the profile.

    line 31
  5. Very specific:

    If the selected profile names a newer FET_000_STANDARD version, use that manifest instead.

    line 44
  6. Very specific:

    Leave physics:approximation unauthored on the neutral base so each runtime payload can set its own value (a local base opinion outranks the …

    line 57
  7. Distinctive:

    Use this checklist when changing the repository:

    line 80
  8. Very specific:

    Create a staged output folder under output_root, using safe lowercase path components.

    line 85
  9. Very specific:

    Place the main USD file at asset_root/<intermediate>/<asset_file>.usd* when repairing NP.005.

    line 116
  10. Distinctive:

    When explicit values are unavailable, use conservative defaults:

    line 130
  11. Distinctive:

    If those commands are not available, use the SimReady Foundations validator entrypoint configured in this checkout or inspect the relevant …

    line 176
  12. Distinctive:

    Do not silently mutate the source asset.

    line 180
  13. Distinctive:

    Do not hide later profile failures after the selected feature gate passes or fails.

    line 181
  14. Distinctive:

    Do not invent geometry, metadata, or runtime behavior that conflicts with the asset intent.

    line 182
  15. Distinctive:

    Keep the user-facing summary short: what was fixed, what still fails, and the first validation gate that blocks progress.

    line 209

≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

SimReady Conform FET_000_STANDARD

Purpose

Use this workflow skill to bring an existing USD asset into conformance with the selected FET_000_STANDARD Core feature contract, then hand the repaired copy back to profile validation.

Default to FET_000_STANDARD@0.2.0 when the user asks for this feature without a version. Use 0.1.0 when the profile, validation report, or user explicitly pins it.

FET_000_STANDARD is the baseline Standard/OpenUSD Core feature. It verifies that an asset has portable file naming, directory layout, path handling, resolvable asset paths, and no unsafe undefined prims before higher-level visual, material, physics, robot, or runtime-specific features are applied. Version 0.1.0 includes NP.006 and the original root-layer-only SR.001. Version 0.2.0 omits both. Nested provenance is SR.003 on FET_033_STANDARD@0.3.0. USD/sidecar provenance union is SR.004 on FET_033_STANDARD@0.4.0.

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.

Prerequisites

Read the source-of-truth files named below before editing. Work on staged outputs where the skill requires them, and keep validation evidence with the result.

Source of Truth

Before changing an asset, load the exact FET_000_STANDARD manifest selected by the profile. In this repo, start with the canonical version:

  • nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_STANDARD-0.2.0.json (latest)
  • nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_STANDARD-0.1.0.json (preserved)
  • nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/features/FET_000_STANDARD.md

This feature has no dependencies. Authoritative requirement lists:

VersionRequirements
0.1.0NP.002, NP.003, NP.004, NP.005, NP.006, NP.007, NP.008, SR.001, HI.010
0.2.0NP.002, NP.003, NP.004, NP.005, NP.007, NP.008, HI.010

If the selected profile names a newer FET_000_STANDARD version, use that manifest instead. Treat the JSON requirement list as authoritative when markdown and JSON disagree.

FET_000_STANDARD is the neutral Core feature and does not require physics runtime variants. Runtime physics variant scaffolding (the RV.* Runtime Variants requirements) lives in the separate runtime Core features FET_000_PHYSX, FET_000_NEWTON, and FET_000_MUJOCO; repair those with their own runtime-specific handling, not this Standard skill.

Because those runtime features layer runtime payloads on top of this neutral base, keep the base runtime-agnostic: it carries only neutral UsdPhysics/physics:* data and geometry (no Physx*/Newton*/Mjc* schemas or physx*:/newton:*/mjc:* attributes), and it must not pin physics:approximation to a runtime-specific value — never sdf on the base. Leave physics:approximation unauthored on the neutral base so each runtime payload can set its own value (a local base opinion outranks the payload arc in LIVRPS and would leak into every runtime selection). See nv_core/tiers/simready_foundation_tier_core/simready/foundation/tier_core/capabilities/core/runtime_variants/runtime-physics-isolation-matrix.md.

For per-requirement repair details, read references/fet-000-standard-requirements.md when a FET_000_STANDARD validation report or inspection identifies matching failures.

Inputs

Collect these before editing:

InputRequirement
usd_assetRequired .usd, .usda, .usdc, or unpacked USD-family asset to repair.
output_rootRequired or inferred folder for staged assets and reports.
simready_profileProfile being validated, such as Robotics-Prop, Robot-Body, or Robot-Gripper.
profile_versionProfile version, if supplied by the user or validation command.
validation_reportPreferred JSON or markdown report from the failing profile/feature validation gate.
source_assetOriginal CAD, DCC, URDF, MJCF, or conversion input path, used for provenance metadata.
asset_name and asset_typeUse explicit user values when provided; otherwise infer conservative defaults from the asset path and profile.

Instructions

Use this checklist when changing the repository:

  1. Confirm the input asset exists and record the original path.
  2. Parse the validation report when available. If no report exists, run the same profile or feature validation gate first when the local tooling is available.
  3. Filter to the selected FET_000_STANDARD version failures and the requirement IDs listed in that manifest. Do not repair unrelated feature failures in this skill.
  4. Create a staged output folder under output_root, using safe lowercase path components.
  5. Copy or export the input asset into the staged folder. Do not overwrite the source asset unless the user explicitly asks for in-place repair.
  6. Apply fixes in this order:
    • Path and layout fixes for NP.002, NP.003, NP.004, and NP.005.
    • Metadata fixes for SR.001 and NP.006 only when the selected version is 0.1.0. If the only Core failure is metadata and the Physical AI Skill Hub commands are available, prefer apply-simready-foundation-metadata over hand-editing.
    • Composition and asset path fixes for NP.007 and NP.008.
    • Undefined prim cleanup for HI.010 only when the affected over can be safely resolved or removed.
  7. Rerun the same validation gate that failed, or the narrowest available FET_000_STANDARD validation gate for the selected version.
  8. Summarize the stage as passed, failed, skipped, or blocked. Stop at the first remaining failing validation gate unless the user asks for best-effort continuation.

Examples

Example request:

Repair FET_000_STANDARD failures on a USD asset, including Core metadata and naming/path issues.

Expected result summary:

staged_asset: repaired copy or output directory
validation: selected feature/profile gate and report path
remaining_failures: next failing requirement IDs, if any

Repair Policy

Make automatic repairs only when the intended result is mechanical and portable:

  • Rename copied files and folders to satisfy the Core naming and path rules.
  • Place the main USD file at asset_root/<intermediate>/<asset_file>.usd* when repairing NP.005.
  • For SR.001 (0.1.0 only), author SimReady_Metadata, asset_name, asset_type, source_file, and usd_date_generated directly in root-layer customLayerData.
  • Rewrite absolute asset paths to relative paths only when the referenced file exists and is inside the staged asset root, or when it is safe to copy/package the dependency into the staged asset root.

Block and report instead of guessing when:

  • A required dependency cannot be found.
  • A path points outside the asset package and copying it would change ownership or licensing assumptions.
  • An undefined prim might be a legitimate composition override after a missing reference is restored.
  • Metadata values would require domain knowledge the user did not provide.
  • Repairing one requirement would invalidate a higher-priority profile requirement.

Metadata Defaults

When explicit values are unavailable, use conservative defaults:

FieldDefault
asset_nameSafe stem of the staged USD asset or asset root folder.
asset_typerobot for robot profiles, prop for prop profiles, otherwise asset.
source_filesource_asset when supplied; otherwise the original input asset path.
usd_date_generatedCurrent date in YYYY-MM-DD format at repair time.

Author these fields at the top level of customLayerData and also include the SimReady_Metadata key.

Tested Metadata Repair

For a converted CAD asset that fails FET_000_STANDARD@0.1.0 only on metadata (SR.001 / NP.006), this command shape has been forward-tested:

uv run --python 3.12 apply-simready-foundation-metadata <usd-asset> \
  --output-dir <output-root>/<asset-name>/simready_usd \
  --profile <profile> \
  --profile-version <version> \
  --source-asset <source-asset> \
  --pipeline-step convert-cad-to-usd \
  --report <output-root>/apply-simready-foundation-metadata.json \
  --markdown-report <output-root>/apply-simready-foundation-metadata.md

Expected repair outputs:

  • A staged copy of the USD asset under <asset-name>/simready_usd/.
  • Root layer customLayerData['SimReady_Metadata'].
  • A same-directory sidecar JSON file.

After rerunning profile validation, count this skill as successful when the selected FET_000_STANDARD version passes, even if the full profile still fails on non-Core features such as units, rigid bodies, multibody physics, or grasp vectors. Report those remaining feature failures as handoff work for their own skills.

Validation Handoff

Preserve reports under the staged output directory. If the Physical AI Skill Hub validation commands are available, the normal handoff is:

uv run --python 3.12 validate-simready-profile <staged-usd> \
  --profile <profile> \
  --profile-version <version> \
  --report <output-root>/validation/fet-000-standard-after-repair.json

If those commands are not available, use the SimReady Foundations validator entrypoint configured in this checkout or inspect the relevant requirement validators directly. Always say which validation path was used.

Limitations

  • Do not silently mutate the source asset; work on the requested staged output.
  • Do not hide later profile failures after the selected feature gate passes or fails.
  • Do not invent geometry, metadata, or runtime behavior that conflicts with the asset intent.

Troubleshooting

  • Error: validation tooling is unavailable. Solution: run the narrowest available USD or static check and report the gap.
  • Error: a repair would change asset intent. Solution: stop and ask for direction or stage the smallest reversible edit.
  • Error: later profile gates still fail. Solution: report the next failing feature and hand off to the matching conformance skill.

Resources

  • assets/openai.yaml preserves optional UI metadata for clients that read skill display hints. It is not required for the workflow.
  • references/ contains detailed requirement notes; load only the files needed for the active validation failure.

Summary Format

Report:

FieldMeaning
input_usd_pathOriginal USD path.
output_usd_pathLatest staged/repaired USD path.
profile and profile_versionValidation target.
requirements_repairedRequirement IDs changed by this skill.
requirements_blockedRequirement IDs that need user or upstream data.
validation_reportPath to the rerun validation report.
next_stepUsually rerun the full selected profile validation.

Keep the user-facing summary short: what was fixed, what still fails, and the first validation gate that blocks progress.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.