Agent skill · NVIDIA
vss-query-analytics
Use this skill when reading video-analytics metrics, incidents, alerts, and sensor data via the VA-MCP server (port 9901). Not for live VLM or incident-range narrative reports.
What it needs
About 4k tokens when loaded.
What this skill does
Purpose Answer read-only analytics questions (incidents, metrics, sensor data) by routing through the VA-MCP server. Prerequisites Active VSS deployment reachable on $HOSTIP (see vss-deploy-profile). 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. 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 Analytics (VA-MCP) Queries incidents, alerts, and metrics stored in Elasticsearch via MCP JSON-RPC at port 9901. ALWAYS run the commands below yourself and relay results to the user. Do NOT guess or describe — actually execute and report back. Scope guard — read-only analytics only. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills NVIDIA/vss-query-analytics