AGENT SKILL

simready-foundation-create-package

Use for creating SimReady packages with package sample scripts, WRAPP setup, root USD inputs, validation phases, and fallback modes.

License 许可
Apache-2.0
所属仓库
leemiracle/work4ai
最近更新
2026-11-12
Stars
★ 4
Forks
0

01 前言 Front Matter

name
simready-foundation-create-package
license
Apache-2.0
metadata
{ "tags": [ "simready", "packaging", "validation" ], "author": "Shaad Boochoon <sboochoon@nvidia.com>" }
description
Use for creating SimReady packages with package sample scripts, WRAPP setup, root USD inputs, validation phases, and fallback modes.

03 SKILL.md 正文

SimReady Create Package

Purpose

Use this skill when a user wants to turn a folder of USD assets into a SimReady package with the bundled package sample workflow.

The skill guides assets/scripts/create_simready_package.py, which runs pre-validation, package creation, and post-validation. The helper package under assets/scripts/sr_pkg_sample/ is bundled with the skill so the workflow can run without reaching back into nv_core/package_sample/.

Prerequisites

Before running packaging commands, confirm:

  • the repository root is simready_foundations
  • Python 3.10 or newer is available in the shell that will run the sample
  • assets/scripts/setup_venv.sh can be run from Git Bash, WSL, or another bash-compatible shell
  • the user has the WRAPP wheel omni_wrapp_minimal-2.2.0-py3-none-any.whl, or has access to an internal index that provides it
  • the source folder contains every USD file and referenced asset that should go into the package
  • the user provides the license that applies to the asset; do not choose a license for them

No OpenAI API key is required.

Inputs

Collect or infer:

Input Requirement
name Package name, lowercase and without spaces, such as apple_a01.
version Package version, such as 1.0.0.
license SPDX identifier or LicenseRef-* expression chosen by the user.
source Folder that contains the root USDs and all referenced files.
repo WRAPP repository path or file:// URL for the full WRAPP flow.
root_usd Relative path inside source for each root USD, repeated with --root-usd.
mode Full flow, pre-validation only, post-validation only, skip phase, or no-WRAPP fallback.

Instructions

Use this checklist from the repository root:

  1. Use the bundled scripts in skills/simready-foundation-create-package/assets/scripts/.
  2. Change into skills/simready-foundation-create-package/assets/scripts/ before running setup or package commands.
  3. If .venv/ already exists, activate it and verify import simready.validate and import wrapp before rebuilding it.
  4. If a virtual environment is needed, run ./setup_venv.sh --wrapp-wheel <path-to-wheel>. Add --extra-index <url> only when the user has a package index that provides missing dependencies.
  5. Activate the virtual environment for every packaging command. If running from outside the repository root, set SIMREADY_FOUNDATIONS_ROOT to the repository root so the bundled helper can find nv_core/sr_specs/docs.
  6. Prefer the default flow for publication:
    python create_simready_package.py <name> <version> <license> <source> <repo> \
        --root-usd <relative/root.usd>
    
  7. Use --only-pre-validation --source <folder> --root-usd <path> when the user is iterating on source-folder conformance before building.
  8. Use --only-post-validation --package-def <path-to-com.nvidia.simready.packaging.json> to validate an already-created package.
  9. Suggest --skip-pre-validation only after a successful pre-validation against the same unchanged source folder.
  10. Suggest --skip-post-validation only when the user intentionally wants to validate the created package later.
  11. Use --no-wrapp only for a minimal package skeleton or when WRAPP cannot be installed. Tell the user it is not suitable for publication and may fail BOM or introspection checks.
  12. Inspect the command return code. Treat stdout as evidence, not proof of success.

Examples

Full package creation:

cd skills/simready-foundation-create-package/assets/scripts
source .venv/bin/activate
python create_simready_package.py apple_a01 1.0.0 Apache-2.0 \
    ~/my_asset/simready_usd ~/my_repo \
    --root-usd sm_apple_a01_01.usd

Pre-validation only while repairing source-folder paths:

python create_simready_package.py --only-pre-validation \
    --source ~/my_asset/simready_usd \
    --root-usd sm_apple_a01_01.usd

No-WRAPP fallback for a local experiment:

python create_simready_package.py apple_a01 1.0.0 MIT \
    ~/my_asset/simready_usd \
    --no-wrapp --skip-post-validation

Failure Handling

  • Pre-validation FET_031_STANDARD or AA.001: report the offending anchored-path failure and ask before editing USD references.
  • Pre-validation usage error: collect the missing --root-usd, missing --source, or invalid folder path.
  • Create error about an existing root .wrapp marker: ask whether to reuse that package name or remove the marker.
  • Create error about nested packages: ask the user to remove nested .wrapp files before retrying.
  • Post-validation FET_030_STANDARD: cite the failing package-core requirement and keep the generated package for inspection.
  • Post-validation FET_032_STANDARD: check whether BOM metadata was written and rerun the full flow if the source did not change.

Policies

  • Do not rewrite the user's USD files automatically while packaging.
  • Do not pick the asset license for the user.
  • Treat assets/scripts/ as the skill-owned copy of the package workflow.
  • Preserve generated reports and metadata unless the user asks for cleanup.
  • Stop after two setup retries and summarize the blocker with the exact command that failed.

Limitations

  • This skill does not replace profile-specific conformance skills for repairing USD content.
  • The WRAPP setup depends on user-provided packages, credentials, or indexes that may not be available in the current shell.
  • The no-WRAPP fallback creates a lightweight package definition and is expected to miss full publication evidence.

Troubleshooting

  • Error: Could not find a version that satisfies the requirement. Solution: verify access to https://pypi.nvidia.com/, then add the user's private index or local wheels.
  • Error: no root USD files specified. Solution: add one or more --root-usd paths relative to the source folder, or use --no-usd-files only for intentional non-USD packages.
  • Error: package source changed after pre-validation. Solution: rerun the default flow so conformance metadata hashes match the current source.
  • Error: WRAPP local backend is disabled. Solution: reinstall the WRAPP wheel with the [local] extra through setup_venv.sh.

Resources

  • assets/scripts/create_simready_package.py is the command-line entrypoint.
  • assets/scripts/setup_venv.sh creates the sample virtual environment.
  • assets/scripts/requirements-package-sample.txt lists the package workflow dependencies.
  • assets/scripts/sr_pkg_sample/ contains the Python API for custom tooling integrations.

Summary Format

Report:

Field Meaning
mode Full flow, pre-validation only, post-validation only, skip phase, or no-WRAPP fallback.
source Source folder that was packaged or checked.
package_name Package name and version.
root_usds Root USD paths supplied to the script.
repo Target WRAPP repository, when used.
first_failing_phase First failed phase, or none.
reports Validation report paths, metadata paths, or package definition path.
next_step Repair source, rerun packaging, publish, or inspect generated evidence.

04 同仓库更多 Skills

leemiracle
leemiracle/work4ai

agentic-ecology-ui

Guidelines and templates for creating a generic web UI to visualize, rank, filter, and annotate vector databases. The UI has a hierarchical structure covering database selection, label selection/definition, ranking/filtering configuration, and row visualization/annotation. Use when building, serving, or adapting an interactive web UI for Hoplite vector databases.

★ 4
leemiracle
leemiracle/work4ai

agentic-ecology-init

Initializes a local uv-managed project directory for agentic ecology workloads. Sets up Python dependencies using reference pyproject.toml and uv.lock, configures workspace rules, and ensures Agentic Ecology skills are discoverable. Use when initializing a new project workspace or bootstrapping a clean environment.

★ 4
leemiracle
leemiracle/work4ai

agentic-ecology-camera-traps

Provides capabilities to run SpeciesNet detector and classifier on camera trap images, extract crop-level feature embeddings, and populate a Hoplite vector database for downstream search and agile modeling. Use when ingesting camera trap images, classifying wildlife photos, or indexing camera trap data.

★ 4
leemiracle
leemiracle/work4ai

agentic-ecology-bioacoustics

Provides bioacoustic analysis capabilities for ecologists and researchers using the perch-hoplite Python package. A typical use case is to use agile modeling to bootstrap the creation and deployment of a bespoke detector for targeted species on an existing collection of passive acoustic monitoring recordings. Use when processing and annotating audio recordings for bioacoustic applications.

★ 4
leemiracle
leemiracle/work4ai

sample-skill

Sample skill used by agent-env integration tests. Exercises SKILL.md parsing plus supporting scripts and references.

★ 4
leemiracle
leemiracle/work4ai

simready-foundation-validate-foundation-change

Use for auditing SimReady requirement, validator, feature, profile, adapter, test, and skill consistency.

★ 4