vss-search-archive

Runs natural-language fusion search over archived video and ingests files or RTSP streams for indexing.

2|Updated Aug 20, 2026
One-click install
npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill vss-search-archive-atomicrajat
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vss-search-archive
Source: https://github.com/atomicrajat/industry_safety_monitoring_system/tree/main/.claude/skills/vss-search-archive
Command: npx skills add https://github.com/atomicrajat/industry_safety_monitoring_system --skill vss-search-archive-atomicrajat

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Searching hours of archived surveillance or operational video manually is slow and error-prone. This Skill lets you query ingested video archives with plain natural language (e.g. "find all instances of forklifts") through the NVIDIA VSS agent backend, and handles ingesting video files or RTSP streams so they become searchable via Cosmos Embed1 embeddings stored in Elasticsearch. ## Core Features & Use Cases - Natural-language video search: Run fusion search (embedding + attribute reranking with an optional VLM critic) through the VSS agent's /generate endpoint and receive timestamped, similarity-scored clips formatted as a professional inspection report. - Agent-backed ingestion: Ingest video files via the three-step chunked-upload handshake or register RTSP streams so embeddings are generated; delete sources with cleanup of both VIOS storage and Elasticsearch indexes. - Guided troubleshooting: Built-in feedback loops for zero-hit results, missing sources, and backend failures, plus discovery modes (wide-net, high-precision, metadata-filtered) for tuning recall vs. precision. - Use Case: A safety officer asks "when did someone enter the restricted area?" — the Skill verifies the source is registered, runs the search, and returns a Video Search Results report with clips, similarity scores, and an optional screenshot verification step. ## Quick Start Ask the agent to find all instances of forklifts in the ingested warehouse video, providing the VSS agent backend host IP.

Frequently Asked Questions about vss-search-archive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search archived video with natural language?

Send a POST request to the VSS agent's /generate endpoint with an input_message describing what to find, such as "find all instances of forklifts". The agent embeds the query, matches it against Cosmos Embed1 vectors in Elasticsearch, and returns timestamped clips ranked by similarity.

How do I ingest a video file for search in VSS?

Use the agent-backed three-step flow: request an upload URL from POST /api/v1/videos, chunked-upload the file to the returned VST URL with nvstreamer headers, then call POST /api/v1/videos/{sensorId}/complete. A bare VIOS upload stores bytes but never generates embeddings.

Can I add an RTSP stream for video search?

Yes, register it with POST /api/v1/rtsp-streams/add providing the sensorUrl and a name. Embedding generation runs in the background, so search hits appear only after enough chunks land in Elasticsearch.

Why does my video search return zero results?

Zero hits usually mean the source was never ingested through the agent backend, the query is too specific, or the similarity threshold is too high. Verify the source appears in the sensor list, then retry with a lower minimum similarity or broader query per the troubleshooting reference.

When should I not use this video search skill?

Do not use it 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). It is scoped to archive search and search ingestion only.