AGENTS.mdA

AGENTS.md from oxbshw/watch-skill is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add oxbshw/watch-skill/AGENTS.md@git:20260902.2964b5b

Pins git:20260902.2964b5b in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
oxbshw/watch-skill
Path
AGENTS.md
Versions recorded
5
Latest version
git:20260902.2964b5b, committed Sep 2, 2026
First version recorded
Aug 14, 2026
Size
5,435 bytes
Repository stars
508
License
MIT

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

# Working on Watch Skill

Read this before changing anything. It is the short version of
[CONTRIBUTING.md](CONTRIBUTING.md) and the rules in
[docs/DECISIONS.md](docs/DECISIONS.md).

## What this project is

A local-first video layer for AI agents. It turns video into a persistent,
searchable index with timestamped evidence, and closes a capture → critique →
fix → proof loop over an agent's own work. Python 3.11+, MIT.

## Layout

| Path | What lives there |
|---|---|
| `src/watch_skill/` | The engine. All logic. |
| `src/watch_skill/surfaces/` | MCP, CLI, REST. Thin wrappers only. |
| `skills/` | The ten agent skills. Canonical location — the skills CLI reads it. |
| `commands/` | Slash commands for the Claude Code plugin. |
| `src/watch_skill/integrations/` | Framework adapters. No engine logic. |
| `templates/agent-integration/` | What a contributor copies to add an agent. |
| `tests/` | Mirrors the `src/` layout. |
| `docs/agents/` | One page per supported agent, each with an honest status. |

## Commands

```bash
uv sync --extra all              # full dev environment
uv run pytest -m "not network"   # the offline suite — must be green
uv run ruff check .              # lint
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add oxbshw/watch-skill/AGENTS.md@sha256:82bdb59365eb29ab

The line at the top of this page pins the label git:20260902.2964b5b, 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_5ldfu4oywum2iml5.svg)](https://markdownregistry.com/a/art_5ldfu4oywum2iml5)

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

Versions

The registry has recorded 5 versions of this file, between Aug 14, 2026 and Sep 2, 2026, about one every 5 days.

versioncommittedcommitsizeaudit
git:20260902.2964b5b latest2026-09-02 2964b5b 5,435 BA view · diff
git:20260902.28412492026-09-02 2841249 5,335 BA view · diff
git:20260831.f38ab422026-08-31 f38ab42 5,331 BA view · diff
git:20260830.fe2e6502026-08-30 fe2e650 5,326 BA view · diff
git:20260814.17f419e2026-08-14 17f419e 4,535 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (5435 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_5ldfu4oywum2iml5
GET https://markdownregistry.com/api/v1/resolve?ref=oxbshw/watch-skill/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/82bdb59365eb29ab865d21db6509df5326eef1f99f46df193a15a7a06c31498e

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: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from oxbshw/watch-skill

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

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261015.0e1f0bf · audit A · 352,890 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 302,424 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261011.412347a · audit A · 284,510 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 193,096 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 170,980 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261011.5d64745 · audit A · 136,966 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 129,649 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 113,780 stars

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