Agent skill · NVIDIA
vss-search-archive
Use this skill to run top-level VSS fusion search on archived video, or to ingest video files / RTSP streams for search. Do NOT use for ad-hoc visual Q&A (use vss-ask-video), live captioning (use vss-deploy-dense-captioning), or video summarization and reports (use vss-summarize-video).
What it needs
About 10k tokens when loaded.
What this skill does
Purpose Run the top-level VSS fusion search across archived video, ingest new clips / RTSP streams for search, and delete search-ingested sources. Prerequisites Active VSS deployment reachable on $HOSTIP (see vss-deploy-profile and references/). vss-manage-video-io-storage skill installed (used to list and manage video sources before search). NGC credentials in $NGCCLIAPIKEY and $NVIDIAAPIKEY for any image pulls. curl, jq, and Docker available on the caller. Instructions Follow the routing tables and step-by-step workflows below. Each section that ends in workflow, quick start, or flow is intended to be executed top-to-bottom. Detailed reference material lives in references/. Examples Worked end-to-end examples are kept under evals/ (each .json manifest contains a runnable scenario) and inline in the per-workflow curl blocks below. Run a Tier-3 evaluation with nv-base validate <this-skill-dir> --agent-eval to replay them. Limitations Requires the matching VSS profile / microservice to be deployed and reachable from the caller. NGC-hosted models and NIMs may be subject to rate-limits, GPU memory requirements, and license restrictions. Concurrency, GPU memory, and storage limits depend on the host hardware and the profile's compose file. Troubleshooting Error: REST call returns connection refused. Cause: target microservice not running. Solution: probe /docs or /health; redeploy via vss-deploy-profile or the matching vss-deploy- skill. Error: HTTP 401/403 from NGC pulls. Cause: missing/expired NGCCLIAPIKEY. Solution: docker login nvcr.io and re-export the key before retrying. Error: container OOM or model fails to load. Cause: insufficient GPU memory for the selected profile. Solution: switch to a smaller variant or free GPUs via docker compose down. Video Search Workflows Alpha Feature — not recommended for production use. Search video archives by natural language using Cosmos Embed1 embeddings. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/vss-search-archive