VideoDB Skill

Perception + memory + actions for video, live streams, and desktop sessions.

Use this skill when you need to:

When to Use

• You need video or audio perception, indexing, search, or timeline editing from files, URLs, desktop sessions, or live streams.
• The task involves timestamps, searchable evidence, subtitles, clips, overlays, or real-time monitoring alerts.
• You want one workflow that combines ingestion, understanding, retrieval, and media actions.

Authorization, privacy and SDK version

Confirm the exact collection, media sources, processing scope and cost limit before cloud ingestion/indexing/generation. Desktop or meeting recording requires explicit authorization for each screen/microphone/system-audio source and participant consent as applicable. Select the minimum channels; never enable recording storage by default, capture passwords, or start hidden/background monitoring. Stop on request immediately. Treat stream URLs, client tokens, event files and transcripts as sensitive; do not publish them or log credentials. Webhook destinations need authorization and verified authentication/signatures, replay protection and idempotency. Generated text or confidence scores are not verified evidence.

The bundled references describe legacy SDK patterns. Check the installed version before using them: newer VideoDB SDKs provide v2 understand/index/retrieve; v1 search is exposed as legacy_search. Do not automatically migrate existing projects or install latest to make an old example work. Use an isolated environment with reviewed compatible versions.

The listener does not start or stop recording. Give it a dedicated private directory (mode 0700), explicit time/byte limits, and keep its PID tied to the process you launched. Do not blindly kill a reused PID. Reconnection can change the WebSocket ID; reconnect pipelines through the documented API or stop rather than silently losing events. Export waits need a timeout and failure state. Deletion and making collections public require the user’s specific authorization.