oxbshw/watch-skill

watching-videos

The user shared a video URL, a YouTube/TikTok/stream link, a local video file, a screen recording, a meeting recording, or a playlist/folder of videos — "watch this", "summarize this video", "what's in this recording".

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/oxbshw/watch-skill --skill watching-videos

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Watching videos

You don't have a video input; this skill gives you one. Anything a user hands you — a YouTube link, a TikTok, a lecture, a meeting recording, a screen capture, an .mp4 on disk — goes through the same pipeline: frames (scene-aware, deduplicated), OCR, transcript (captions first, local Whisper offline fallback), all persisted into one index.

Before watching: check the index

bash
watch-skill list

If the video was already analyzed — this session or any earlier one — do NOT watch it again. Ask it directly (see the asking-with-evidence skill):

bash
watch-skill ask <video_id> "<question>"

One video

bash
watch-skill watch "<url-or-path>" [--start T --end T] [--max-frames N] [--transcript-only]
  • Works on any yt-dlp-supported site (1800+), direct media URLs, HLS/DASH

manifests (--duration 60 bounds live streams), and local files.

  • Video over ~10 minutes and the user cares about one part → use

--start/--end for dense sampling of that window.

  • User only needs what was said → --transcript-only (fastest, often no

video download at all).

The report prints Indexed: <video_id>, frames with t=MM:SS timestamps, OCR text, and the transcript. Read every frame path listed — in a single message, parallel Read calls — then answer from frames + OCR

  • transcript, citing timestamps.

Many videos (playlist, channel, folder)

bash
watch-skill batch "<playlist-url-or-folder>" [--limit N]

Everything lands in the same index; one broken video never stops the rest. Afterwards a single watch-skill search "<phrase>" spans the whole batch.

First run on a machine

If any command fails with a dependency error, run watch-skill doctor once — it installs missing ffmpeg/yt-dlp itself. No API key is required for any of this; transcription is local by default and the video file never leaves the machine.

按任务相关推荐

来自同一仓库

更多 Skills

全部 Skills
oxbshw
社区

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". Use this to answer from the persistent index with timestamped evidence and a confidence score instead of re-watching or guessing.

安装量
2
GitHub Stars
503
最近更新
10月14日
oxbshw
社区

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.

安装量
2
GitHub Stars
503
最近更新
10月14日
oxbshw
社区

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.

安装量
2
GitHub Stars
503
最近更新
10月14日
oxbshw
社区

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.

安装量
2
GitHub Stars
503
最近更新
10月14日