mcpField
I
i4h-workflow-setup

i4h-workflow-setup

github.com/nvidiaDevelopment3.8k70 installsUpdated today
Repository

About i4h-workflow-setup

A setup skill for preparing the i4h workflow runtime and checking that workflow discovery and linting work. It separates host preflight and full setup from checks that require Isaac Sim or an actual rollout.

Key features

  1. 01Resolve or reuse the base checkout
  2. 02Check host and runtime prerequisites
  3. 03Run default full setup
  4. 04Verify workflow discovery and linting
  5. 05Report failures and next smoke command

Use cases

  1. 01Prepare an i4h workflow environment
  2. 02Check whether host requirements are met
  3. 03Verify discovered workflows and lint results

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nvidia/skills --skill i4h-workflow-setup

After installing, type/i4h-workflow-setupin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

BENCHMARK.md
skill-card.md
skill.oms.sig
evals/
evals.json

Details

From the project README

i4h Workflow Setup

Purpose

Prepare the complete runtime, then prove dependency-light workflow discovery works.

Instructions

  1. Resolve the base checkout.
  2. Run every host preflight check.
  3. Run default full setup.
  4. Verify discovery and lint --all.

Resolve the checkout

export I4H_WORKFLOWS_REPO_URL="${I4H_WORKFLOWS_REPO_URL:-https://github.com/isaac-for-healthcare/i4h-workflows}"
I4H_REPO_DIR_NAME="${I4H_WORKFLOWS_REPO_URL%/}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME##*/}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME##*:}"
I4H_REPO_DIR_NAME="${I4H_REPO_DIR_NAME%.git}"
[ -n "$I4H_REPO_DIR_NAME" ] || { echo "Cannot derive a checkout name from I4H_WORKFLOWS_REPO_URL" >&2; exit 2; }
ROOT="${I4H_WORKFLOWS:-$(git rev-parse --show-toplevel 2>/dev/null)}"
if [ ! -d "$ROOT/workflows/i4h_workflows" ]; then
  ROOT="${I4H_WORKFLOWS:-$HOME/$I4H_REPO_DIR_NAME}"
  [ -d "$ROOT/workflows/i4h_workflows" ] || git clone "$I4H_WORKFLOWS_REPO_URL" "$ROOT"
fi
export I4H_WORKFLOWS="$ROOT"
cd "$ROOT"

Treat this resolver as part of the skill contract: a hosted copy may run outside the base repository, so never assume the current checkout contains workflows/i4h_workflows. I4H_WORKFLOWS_REPO_URL selects the clone source. When I4H_WORKFLOWS is unset, derive the fallback directory from that URL; set I4H_WORKFLOWS only to reuse or choose a specific destination. Never replace an existing checkout.

Preflight

uname -srm
command -v uv
command -v git
nvidia-smi
df -h .
./setup.sh --help

Require supported Linux on x86_64 or aarch64, uv, Git, network access for missing packages/assets, sufficient disk and model-cache space, and an NVIDIA driver compatible with the repository's Isaac Sim version. Read the exact current requirements from ./README.md; do not rely on remembered version numbers. Require Docker only when the requested local VLM or Cosmos service needs it.

Sync

Run the default full setup:

./setup.sh

The explicit equivalent is:

./setup.sh all

Use ./setup.sh clean only when the user explicitly requests a full rebuild or cleanup because it deletes generated caches, component environments, and third-party checkouts. Setup is idempotent; do not clean as a generic repair. The setup script restores pinned third-party sources and the upstream Isaac Sim skill catalog; do not copy that catalog into skills/.

Verify

./run.sh list
./run.sh lint --all
test -f ./third_party/IsaacSim-045ca8b/skills/SKILLS.md

Use run.sh show <workflow> --mode <mode> when the user named a workflow. These checks prove discovery and contracts without importing Isaac Sim. Use i4h-workflow-validate for an actual rollout.

Troubleshooting

On failure, report the first host, network, checkout, or uv-sync error and rerun full setup only after correcting that cause.

Prerequisites

Require supported Linux, network access, uv, Git, disk space, and a compatible NVIDIA GPU/driver for simulator use.

Limitations

Setup does not download every optional checkpoint or prove any rollout succeeds. clean is destructive to generated environments and third-party checkouts.

Examples

  • Set up the i4h workflow on this machine and tell me if any host requirements are missing. → preflight, run default full setup, then run discovery and lint --all.

Completion gate

Report every host check, synced target, first failing component if any, discovery/lint results, and the smallest next smoke command. Do not claim simulator or policy success from setup alone.

Comments

Markdown supported