vss-manage-video-io-storage

This skill drives the VIOS (Video I/O and Storage) REST API and the companion NvStreamer API for NVIDIA's VSS blueprint. It solves the problem of managing camera/sensor inventory, RTSP streams, recordings, snapshots, clip extraction, timelines, and video storage by calling documented REST endpoints directly with curl and jq, rather than navigating a UI. It includes explicit routing rules so the agent picks the right path, for example using the direct VIOS file-storage endpoint for a plain MP4 upload versus the NvStreamer upload-to-RTSP-URL handoff only when a live or synthetic RTSP feed is actually requested.

The skill bundles four reference contracts: the full VIOS REST API reference (sensors, storage, snapshots, clip extraction, WebRTC live/replay, RTSP proxy, recorder, service discovery), the NvStreamer API reference (uploads, snapshots, storage info, filesystem scan), and an integration contract describing how VIOS plugs into peer services (RT-VLM, ELK, Kafka, Redis, SDRC). It also documents a sample-data bootstrap that downloads a fixed NGC bundle of eight demo MP4s, with strict instructions never to substitute a similar-sounding file or fabricate upload responses.

Target users are operators and agents running VSS who need to manage video ingestion and storage. The skill deliberately scopes itself away from VLM inference, semantic search, summarization, and analytics (each delegated to a sibling skill). Security-relevant notes: credentials are read from NGC environment variables and the skill fails with an actionable error if they are missing; delete operations are genuinely destructive but are documented with warnings.