oxbshw/watch-skill

asking-with-evidence

The user asks a question about a video that was already watched or indexed — "what did they say about X", "what error code appears", "what happens at 2:30", "does the video show Y".

Vedi sorgente

Come usare

  1. Copia il comando e controlla il pacchetto prima di installarlo nel tuo ambiente agente.
  2. Controlla strumenti, credenziali e ambienti richiesti nel documento originale.
  3. Descrivi input e risultato desiderato; confronta l’output con le fonti.
npx skills add https://github.com/oxbshw/watch-skill --skill asking-with-evidence

Prima di iniziare

  • L’installazione non include abbonamenti, quote API o accesso ai file.
  • Stelle e installazioni indicano attività, non un test indipendente di qualità o sicurezza.
Documento Skill originale

Contenuto dal repository con titoli, esempi, codice, tabelle, link e immagini preservati.

Asking with evidence

Every watched video sits in a persistent index. Questions about it are answered from that index — text first, frames only when needed — with timestamps, a confidence score, and an honest refusal when the video does not show the answer. Never re-run a watch for a follow-up.

Answer a question

bash
watch-skill ask <video_id-or-original-url> "<question>"

Any language works; the answer comes back in the language of the question. The engine escalates on its own when unsure (dense re-sampling, zoom-crop re-OCR, stronger model) and prints a ~N tokens saved line.

Three rules for reading the result:

  • Cite the timestamps it gives you; they are real evidence, not

decoration.

  • Trust the refusal. When it says the video does not clearly show

the answer, that is the answer. Do not invent one past it.

  • Frame paths are listed only when the engine wants you to look

yourself — Read them then (or force with --frames).

"What happens at 2:30?"

Moment questions get a dense window, not a whole-video ask:

bash
watch-skill ask <video_id> "what is on screen around 2:30?"

The answer engine pulls frames, transcript and OCR around the moment it resolves. Agents on MCP have a dedicated get_moment tool that takes an explicit timestamp and window; the CLI answers the same question through ask.

Don't know which video? Search them all

bash
watch-skill search "<phrase>"

Hybrid keyword + semantic search across every video ever watched, with per-script normalization (Arabic folding, CJK segmentation, Thai segmentation). Follow a hit with ask or moment on that video.

When the user corrects you

Report it so the next answer is better — see the learning-from-mistakes skill.

Correlati per attività

dallo stesso repository

Altri Skills

Tutti gli Skills
oxbshw
Community

configuring-vision

The user wants to connect an LLM or vision provider, already has an API key, asks "can I use OpenAI/Anthropic/Gemini/OpenRouter", wants local Ollama, or needs different cheap and strong models. Use this to configure provider-neutral visual understanding without tying Watch Skill to one agent or model vendor.

installazioni
2
GitHub Stars
503
Aggiornato
14 ott
oxbshw
Community

extracting-structure

The user wants structure pulled out of a watched video — "make chapters for this video", "where does the bug appear in this recording", "turn this screen recording into a bug report", "how strong is my intro/hook". Use this for deterministic extraction from the index — chapters with timestamps, a fileable bug report with the exact frame, or a scored hook analysis.

installazioni
2
GitHub Stars
503
Aggiornato
14 ott
oxbshw
Community

learning-from-mistakes

The user corrected an answer about a video — "no, it actually says X", "that's the wrong timestamp", "you misread the error code" — or asks why a video answer was wrong. Use this to record the correction as a lesson so future answers on similar questions improve, and to show what the system has learned and saved.

installazioni
2
GitHub Stars
503
Aggiornato
14 ott
oxbshw
Community

recovering-from-errors

A Watch Skill command failed, video download broke, ffmpeg or yt-dlp is missing, a provider returned an error, local vision stopped, or the user asks "why can't it watch this" or "repair my setup". Use this to diagnose and apply the engine's structured fix before retrying the original operation.

installazioni
2
GitHub Stars
503
Aggiornato
14 ott