recovering-from-errors SKILL.md skillA

recovering-from-errors 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/recovering-from-errors@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/recovering-from-errors/SKILL.md
Versions recorded
8
Latest version
v1.4.3, committed Sep 8, 2026
First version recorded
Aug 8, 2026
Size
1,818 bytes
Repository stars
508
License
MIT

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.

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

# Recovering from errors

Failures use stable error codes and include an actionable `fix`. Preserve that evidence;
do not replace it with a generic explanation.

## Diagnose first

```bash
watch-skill doctor --json
```

Read the failing checks and apply only their stated fixes. `doctor` can repair managed
ffmpeg and yt-dlp binaries, stale locks, corrupt caches, missing frame directories, and
known local-model health failures. Re-run it once after remediation.

## Retry the original operation once

After doctor is green, repeat the command that failed. If it returns another structured
error, report its code, message, and fix. Do not loop indefinitely, silently switch cloud
providers, enable cloud STT, or reprocess an already indexed video.

Common routes:

- acquisition or extractor failure: `watch-skill doctor --json`, then retry the watch;
- provider authentication: verify the matching `WATCHSKILL_*_API_KEY` locally;
- provider model not found: run `watch-skill setup-vision` with a valid vision model;
- low memory or local server failure: reduce the local model/context or select a cloud
  provider the user already has;
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add oxbshw/watch-skill/recovering-from-errors@sha256:b179302c903fe316

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_22ymccnkb4uyj32f.svg)](https://markdownregistry.com/a/art_22ymccnkb4uyj32f)

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 1,818 BA view · diff
v1.4.22026-09-08 b6ee470 1,818 BA view · diff
v1.4.12026-09-07 8df6d4d 1,818 BA view · diff
v1.4.02026-09-05 1a53bae 1,818 BA view · diff
v1.4.0rc12026-09-02 ab36fc4 1,821 BA view · diff
v1.3.0rc22026-08-19 db22dfd 1,821 BA view · diff
v1.3.0rc12026-08-19 ba68f9f 1,821 BA view · diff
v1.2.02026-08-08 c41ceaf 1,818 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 (1818 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_22ymccnkb4uyj32f
GET https://markdownregistry.com/api/v1/resolve?ref=oxbshw/watch-skill/recovering-from-errors
GET https://markdownregistry.com/api/v1/blob/b179302c903fe316a10153de0f0a54c46626290230bf5d861ad5acca35d78b44

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
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
watching-videos SKILL.md skill
oxbshw/watch-skill · skills/watching-videos/SKILL.md · The user shared a video URL, a YouTube/TikTok/stream link, a local video file, a screen recording, a meeting recording…
v1.4.3 · audit A · 508 stars

Every file in oxbshw/watch-skill

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