Agent skill

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

MITAuto-check: notesMedia & Creative

Install Recovering From Errors

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/recovering-from-errors .claude/skills/recovering-from-errors && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .claude/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/recovering-from-errors .agents/skills/recovering-from-errors && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .agents/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/recovering-from-errors .cursor/skills/recovering-from-errors && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .cursor/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/oxbshw/watch-skill.git --path skills/recovering-from-errors

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/recovering-from-errors .gemini/skills/recovering-from-errors && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .gemini/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/recovering-from-errors .github/skills/recovering-from-errors && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .github/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add oxbshw/watch-skill --skill recovering-from-errors -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install oxbshw/watch-skill recovering-from-errors --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/oxbshw/watch-skill.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/recovering-from-errors .opencode/skills/recovering-from-errors && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "recovering-from-errors" agent skill from https://github.com/oxbshw/watch-skill/tree/main/skills/recovering-from-errors into .opencode/skills/recovering-from-errors/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "recovering-from-errors", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: recovering-from-errors
GitHub stars: 469
Token cost: ~455 tokens
SKILL.md length: 196 words
Files: 1
Skills in repo: 10
Repo updated: Sep 14, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

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

Tasks that involve Video production
SKILL.md covers Diagnose first and Retry the original operation…
Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Recovering From Errors is an agent skill from oxbshw/watch-skill. 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.

Its SKILL.md is about 460 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Media & Creative, covering Video production. It works with FFmpeg and DeepSeek. The repository describes itself as: Give AI agents eyes, ears, and verifiable results. Watch Skill turns video, audio and screen activity into searchable, timestamped evidence and proves work with deterministic… The licence is MIT.

When your agent uses it

Tasks that involve Video production

Example prompts

“why can”
“repair my setup”
“/recovering-from-errors”

Requirements

Pre-approved tools (allowed-tools): Bash, Read

What it can do on your machine

Read from SKILL.md and the folder at commit f1317c8. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves these tools, so the agent can use them without asking each time:
- Bash
- Read
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Recovering From Errors loads about 455 tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 196 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~80
When it runs · the whole SKILL.md, loaded when a task matches: ~455

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
```
allowed-tools: Bash, Read
```

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from oxbshw/watch-skill at commit f1317c8, republished under its MIT licence (© oxbshw). 196 words, ~455 tokens.

Download SKILL.mdSave it as .claude/skills/recovering-from-errors/SKILL.md (or your agent's skills folder).

name: recovering-from-errors
description: 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.
allowed-tools: Bash, Read
version: 1.4.3
license: MIT
user-invocable: true

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;
unknown video ID: watch-skill list, then use the listed ID or original source.

Security and cost policy are invariants during recovery. Never upload the video file, enable a paid provider, or raise the cost ceiling merely to make an error disappear.

Files

Just SKILL.md in skills/recovering-from-errors of oxbshw/watch-skill.

Open the folder on GitHubat commit f1317c8

Compare with similar skills

Recovering From Errors next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Recovering From Errors compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Recovering From Errors this skilloxbshw/watch-skill	469	—	~455	Automated safety check: Notes	MIT	25 days ago
Remotion Best Practiceslyonjs/shortvid.io	147	33 repos	~1k	Automated safety check: Pass	MIT	yesterday
HyperFrames Video Entry Pointheygen-com/hyperframes	59k	3 repos	~5.2k	Automated safety check: Pass	Apache-2.0	today
Vox DirectorAlisa0808/vox-director	2.2k	—	~5.6k	Automated safety check: Pass	MIT	4 days ago
Video Synceternityspring/reelbench-skills	872	1 repos	~1k	Automated safety check: Notes	Apache-2.0	18 days ago
Ffmpeg Skillkajisho5/ffmpeg-skill	1.9k	—	~7.4k	Automated safety check: Pass	MIT	4 days ago

Similar skills

Remotion Best Practices
lyonjs/shortvid.io
Best practices for Remotion - Video creation in React. An agent skill from lyonjs/shortvid.io.
147 GitHub starsUsed in 33 repos~1k tokens
Media & CreativeAuto-check passed
HyperFrames Video Entry Point
heygen-com/hyperframes
Entry point for making, editing and rendering videos from HTML compositions with HyperFrames, routing each request to the right workflow.
59k GitHub starsUsed in 3 repos~5.2k tokens
Media & CreativeAuto-check passed
Vox Director
Alisa0808/vox-director
Turn ONE topic into a finished Vox-style paper-collage explainer / ad video, end to end on the Atlas Cloud API + local ffmpeg — script, collage keyframes, motion, voice-over, music, captions, all…
2.2k GitHub stars~5.6k tokensUpdated 4 days ago
Media & CreativeAuto-check passed
Video Sync
eternityspring/reelbench-skills
把拉片数据和原片合成一条能直接看的视频：一边是画面，一边是这一镜的分镜信息（镜号、起止、时长、景别、类别、运镜、画面描述、台词），镜头切了信息跟着切，镜头表自动滚动并高亮当前这一镜。
872 GitHub starsUsed in 1 repo~1k tokens
Media & CreativeAuto-check: notes
Ffmpeg Skill
kajisho5/ffmpeg-skill
Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…
1.9k GitHub stars~7.4k tokensUpdated 4 days ago
Media & CreativeAuto-check passed
Painted Animation
tuzhechen2005/opus-video-skills
Make hand-painted watercolour-and-ink cartoon videos (MP4) with code — p5.js + p5.brush rendered frame by frame in headless Chrome, encoded with ffmpeg — starring Clawd or any character.
137 GitHub starsUsed in 1 repo~1.9k tokens
Media & CreativeAuto-check passed

More from oxbshw/watch-skill

All 10 skills in this repo

Asking With Evidence
oxbshw/watch-skill
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".
469 GitHub stars~550 tokensUpdated 25 days ago
Auto-check: notes
Configuring Vision
oxbshw/watch-skill
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.
469 GitHub stars~509 tokensUpdated 25 days ago
Auto-check: notes
The Loop
oxbshw/watch-skill
The user built or changed something visual — a UI, an animation, a game, a generated video — and wants it verified, or asks "why does my UI look wrong", "check that the fix actually worked", "does…
469 GitHub stars~622 tokensUpdated 25 days ago
Auto-check: notes
Video Memory
oxbshw/watch-skill
The user asks about videos watched in the past or across sessions — "have we watched anything about X", "which video showed that error", "what did that meeting decide", "search my videos", or a…
469 GitHub stars~569 tokensUpdated 25 days ago
Auto-check: notes
Watching Videos
oxbshw/watch-skill
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…
469 GitHub stars~599 tokensUpdated 25 days ago
Auto-check: notes
Extracting Structure
oxbshw/watch-skill
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…
469 GitHub stars~490 tokensUpdated 25 days ago
Auto-check: notes

Works with

Questions about Recovering From Errors

What does Recovering From Errors do?

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". Recovering From Errors is an agent skill from oxbshw/watch-skill. 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".

When should I use Recovering From Errors?

Recovering From Errors fits situations like: tasks that involve Video production.

How do I install Recovering From Errors in Claude Code?

Run `npx skills add oxbshw/watch-skill --skill recovering-from-errors -a claude-code`. Or copy the skill folder (skills/recovering-from-errors in oxbshw/watch-skill) into .claude/skills/recovering-from-errors in your project. Claude Code loads it when a task matches its description.

How do I install Recovering From Errors in Codex?

Run `npx skills add oxbshw/watch-skill --skill recovering-from-errors -a codex`. Or copy the skill folder (skills/recovering-from-errors in oxbshw/watch-skill) into .agents/skills/recovering-from-errors in your project. Codex loads it when a task matches its description.

Can I use Recovering From Errors in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add oxbshw/watch-skill --skill recovering-from-errors -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/recovering-from-errors, .gemini/skills/recovering-from-errors, .github/skills/recovering-from-errors and .opencode/skills/recovering-from-errors in your project.

What does Recovering From Errors need to run?

SKILL.md names no scripts, command-line tools or credentials: Recovering From Errors is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read.

Does Recovering From Errors access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Recovering From Errors safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Recovering From Errors use?

Recovering From Errors is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Recovering From Errors use?

About 455 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Recovering From Errors?

Skills that share tags, products or a category with Recovering From Errors: Remotion Best Practices (lyonjs/shortvid.io, 147 stars), HyperFrames Video Entry Point (heygen-com/hyperframes, 59k stars), Vox Director (Alisa0808/vox-director, 2.2k stars) and Video Sync (eternityspring/reelbench-skills, 872 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Recovering From Errors?

oxbshw (a GitHub user) maintains it in oxbshw/watch-skill, which has 469 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on September 14, 2026.

Source: oxbshw/watch-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Recovering From Errors

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Recovering from errors

Diagnose first

Retry the original operation once

Files

Compare with similar skills

Similar skills

More from oxbshw/watch-skill

Related

Questions about Recovering From Errors