SkillsAdd

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".

Trending #8434 Hot #1739 First seen Jul 12, 2026

Installation

$ npx skills add oxbshw/watch-skill --skill watching-videos
View on skills.sh ↗ GitHub repository ↗

Summary

  • 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".
  • Use this to actually watch the video — download, extract frames, OCR, transcribe, and index it — instead of guessing from the title or asking the user to describe it.

Also in this package

Other skills from oxbshw/watch-skill.

npx skills add oxbshw/watch-skill
watch 7 extracting-structure 8 asking-with-evidence 6 video-memory 6 the-loop 244 sharing-results 243 recovering-from-errors 6 learning-from-mistakes 6 configuring-vision 6

Browse all from oxbshw/watch-skill

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 340
License LICENSE
Default branch main
Open issues 0
Status Active

Skill metadata

Parsed from SKILL.md frontmatter.

Version1.4.3
LicenseMIT
Allowed toolsBash, Read

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 2,417 B
  • docs SUMMARY.md 411 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 255 installs

SKILL.md

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

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):

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

One video

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)

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.