vss-ask-video

Route visual questions about video clips to the VSS video_understanding tool.

Updated May 29, 2026
One-click install
npx skills add https://github.com/rblake2320/vigil --skill vss-ask-video-rblake2320
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: vss-ask-video
Source: https://github.com/rblake2320/vigil/tree/main/.claude/skills/vss-ask-video
Command: npx skills add https://github.com/rblake2320/vigil --skill vss-ask-video-rblake2320

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables users to obtain fresh, frame-level insights about a recorded video by querying the VSS agent's video_understanding tool, especially when existing outputs or metadata cannot answer.

Core Features & Use Cases

  • Fresh visual Q&A: ask the VLM to analyze a clip for objects, actions, or safety-related details.
  • Sensor/clip-based inquiries: works with a named sensor/clip to retrieve specific visual facts.
  • Guardrails: ensures not using prior tool outputs or searched results when a new frame analysis is needed.

Quick Start

Provide a fresh visual question to the VSS agent for the specified sensor/clip and return the analysis.

Frequently Asked Questions about vss-ask-video

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

FAQPage Schema
How do I ask visual questions about specific objects or actions in a recorded video clip?

Visual question answering on video clips works by routing queries to the VSS video_understanding tool, which runs fresh frame analysis on a named sensor to extract visual facts like objects, actions, and safety details.

Can I run ad-hoc video understanding queries on a named sensor without relying on existing metadata?

Yes, you can run ad-hoc video understanding queries on a named sensor without searching prior tool outputs, because the skill enforces guardrails to ensure fresh frame analysis is performed for each visual question.

Do I need a specific VSS profile to enable visual question answering on video frames?

Yes, enabling visual question answering requires a VSS base or lvs profile with the video_understanding tool exposed on the agent, plus a list of sensors available via the VST API.

What types of visual facts can I retrieve from video clips using VSS frame analysis?

VSS frame analysis retrieves visual facts about objects, people, actions, colors, timing, and safety details from video clips by running fresh frame-level analysis on the specified sensor.

When should I avoid using prior tool outputs for video clip visual analysis?

You should avoid using prior tool outputs for video clip visual analysis whenever a new frame analysis is needed, because the skill enforces guardrails that require fresh queries to the VLM for accurate visual facts.

How do I start querying fresh visual insights from video frames using the VSS agent?

To start querying fresh visual insights, provide a visual question to the VSS agent for the specified sensor or clip, and the agent will return the analysis by running the video_understanding tool on the requested frames.