watching-videos SKILL.md skillA

watching-videos from oxbshw/watch-skill is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add oxbshw/watch-skill/watching-videos@v1.4.3

Pins v1.4.3 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
oxbshw/watch-skill
Path
skills/watching-videos/SKILL.md
Versions recorded
8
Latest version
v1.4.3, committed Sep 8, 2026
First version recorded
Aug 8, 2026
Size
2,417 bytes
Repository stars
508
License
MIT

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.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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`
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add oxbshw/watch-skill/watching-videos@sha256:2631f6fe57a4bcdb

The line at the top of this page pins the label v1.4.3, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_fqtatq5jmlvkpeee.svg)](https://markdownregistry.com/a/art_fqtatq5jmlvkpeee)

5 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 8 versions of this file, between Aug 8, 2026 and Sep 8, 2026, about one every 4 days.

versioncommittedcommitsizeaudit
v1.4.3 latest2026-09-08 f1317c8 2,417 BA view · diff
v1.4.22026-09-08 b6ee470 2,417 BA view · diff
v1.4.12026-09-07 8df6d4d 2,417 BA view · diff
v1.4.02026-09-05 1a53bae 2,417 BA view · diff
v1.4.0rc12026-09-02 ab36fc4 2,420 BA view · diff
v1.3.0rc22026-08-19 db22dfd 2,420 BA view · diff
v1.3.0rc12026-08-19 ba68f9f 2,420 BA view · diff
v1.2.02026-08-08 c41ceaf 2,417 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (2417 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

oxbshw/watch-skill · 508 stars · license MIT · pushed 2026-10-14 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_fqtatq5jmlvkpeee
GET https://markdownregistry.com/api/v1/resolve?ref=oxbshw/watch-skill/watching-videos
GET https://markdownregistry.com/api/v1/blob/2631f6fe57a4bcdb12ad5193df6e163db6efe3ed50a7e3de67bbb645707510cb

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from oxbshw/watch-skill

AGENTS.md AGENTS.md file
oxbshw/watch-skill · AGENTS.md
git:20260902.2964b5b · audit A · 508 stars
llms.txt llms.txt file
oxbshw/watch-skill · llms.txt
git:20260908.f1317c8 · audit A · 508 stars
asking-with-evidence SKILL.md skill
oxbshw/watch-skill · skills/asking-with-evidence/SKILL.md · The user asks a question about a video that was already watched or indexed — "what did they say about X", "what error…
v1.4.3 · audit A · 508 stars
configuring-vision SKILL.md skill
oxbshw/watch-skill · skills/configuring-vision/SKILL.md · The user wants to connect an LLM or vision provider, already has an API key, asks "can I use…
v1.4.3 · audit A · 508 stars
extracting-structure SKILL.md skill
oxbshw/watch-skill · skills/extracting-structure/SKILL.md · The user wants structure pulled out of a watched video — "make chapters for this video", "where does the bug appear in…
v1.4.3 · audit A · 508 stars
learning-from-mistakes SKILL.md skill
oxbshw/watch-skill · skills/learning-from-mistakes/SKILL.md · The user corrected an answer about a video — "no, it actually says X", "that's the wrong timestamp", "you misread the…
v1.4.3 · audit A · 508 stars
recovering-from-errors SKILL.md skill
oxbshw/watch-skill · skills/recovering-from-errors/SKILL.md · A Watch Skill command failed, video download broke, ffmpeg or yt-dlp is missing, a provider returned an error, local…
v1.4.3 · audit A · 508 stars
sharing-results SKILL.md skill
oxbshw/watch-skill · skills/sharing-results/SKILL.md · The user wants to share or hand off what was found in a video — "send this analysis to my team", "make a page I can…
v1.4.3 · audit A · 508 stars
the-loop SKILL.md skill
oxbshw/watch-skill · skills/the-loop/SKILL.md · The user built or changed something visual — a UI, an animation, a game, a generated video — and wants it verified, or…
v1.4.3 · audit A · 508 stars
video-memory SKILL.md skill
oxbshw/watch-skill · skills/video-memory/SKILL.md · The user asks about videos watched in the past or across sessions — "have we watched anything about X", "which video…
v1.4.3 · audit A · 508 stars
watch SKILL.md skill
oxbshw/watch-skill · skills/watch/SKILL.md · Watch any video (URL, stream, or local path) via Watch Skill. Downloads, extracts scene-aware deduped frames, OCRs…
v1.4.3 · audit A · 508 stars

Every file in oxbshw/watch-skill

Browse by kind, by grade A, or by owner.