hsb-setup

This skill brings up an NVIDIA Holoscan Sensor Bridge demo environment end to end. It clones the latest HSB repository, asks which supported devkit is in use, auto-detects the platform, configures the host per platform, builds the correct demo container, runs it, and verifies HSB connectivity by pinging the board at a fixed address and reading the FPGA version. It solves the multi-step, platform-specific setup problem of getting a sensor bridge devkit from a fresh state to a working, connected demo.

The workflow is interactive and gated. It reads environment variables (SSH_TARGET and REMOTE_ROOT are required; HSB_PLATFORM and a custom HSB_REPO URL are optional), presents an explicit phase plan the user must acknowledge, and runs a mandatory token-budget preflight before any remote command. It then confirms the physical setup, establishes SSH to the devkit, detects the platform by reading the product name and mapping it to a build mode, clones or refreshes the repository from the public NVIDIA repo (or a user-supplied URL), studies the repo user guide, configures the host and network with the correct container build flags per platform (dGPU vs iGPU), builds and runs the demo container, verifies board connectivity, and checks the FPGA version against the host software — suggesting the hsb-flash skill if they mismatch. It reports issues per phase, attempts safe fixes, offers to export a report, and finally stops apps and hands control back to the user.

It targets NVIDIA Holoscan hardware developers setting up sensor bridge devkits (IGX Orin, AGX Orin, AGX Thor, DGX Spark). It has side effects on the host (installing configuration, building containers, using sudo for privileged commands), so it is non-autonomous and runs only when explicitly invoked. A benchmark documents that it passed NVIDIA's NVSkills-Eval.