configuring-vision skill by oxbshw

Configuring vision

Watch Skill's agent surface and model backend are separate choices. Claude Code, Codex, Cursor, OpenClaw, framework agents, and REST clients all call the same engine; the engine can send selected frames to any supported vision provider.

Supported providers

watch-skill setup-vision --provider anthropic --api-key <KEY>
watch-skill setup-vision --provider openai --api-key

Prefer a key the user already has. Do not claim Ollama is required, and do not ask the user to reveal a secret in chat. They can set the matching environment variable or run the command privately in their terminal.

Route bulk work and verification separately

One model can serve both tiers:

Or use a cheaper model for scene descriptions and a stronger model for uncertain answers and loop critiques:

Add --verify to make one live probe call. If it fails, report the structured error and its fix; never echo the key.

No provider is also valid

Without a vision API, Watch Skill still acquires video, reads captions, runs local transcription and OCR, indexes evidence, and searches it. Visual synthesis degrades to timestamped evidence instead of guessing.