Grimoire

Skill-ul watch – Analiză video cu Claude

2 min read

Skill-ul watch – Analiză video cu Claude

All guides

Ce face

Skill-ul /watch oferă lui Claude capacitatea de a „vedea” un video. Scriptul Python descarcă fișierul cu yt-dlp, extrage cadre JPEG scalate automat cu ffmpeg, obține transcrierea timestamp-ată din subtitrările native sau, în lipsa lor, prin Whisper API (Groq sau OpenAI) și returnează căile către cadre + transcript. Claude citește apoi imaginile cu Read și răspunde la întrebări despre conținut.

Când îmi folosește

Îl folosești când vrei să pui întrebări concrete despre un clip: „Ce spune prezentatorul între 02:15 și 03:40?”, „Ce text apare pe ecran la minutul 7?” sau „Descrie secvența de animație de la început”. Este util pentru review de tutoriale, analiză de demo-uri sau verificarea conținutului unui video lung fără să-l vizionezi integral.

Cum îl invoc / declanșez

Invocarea se face cu argumentul obligatoriu <video-url-or-path> și opțional o întrebare:

/watch <video-url-or-path> [question]

Înainte de fiecare rulare, skill-ul execută automat preflight-ul:

python3 "${CLAUDE_SKILL_DIR}/scripts/setup.py" --check

Dacă scriptul iese cu cod diferit de 0, rulezi installer-ul idempotent:

python3 "${CLAUDE_SKILL_DIR}/scripts/setup.py"

Pe macOS cu Homebrew se instalează automat ffmpeg și yt-dlp. Pe Linux/Windows afișează comenzile exacte de instalat. Dacă lipsește cheia Whisper, skill-ul folosește AskUserQuestion și scrie cheia în ~/.config/watch/.env.

Exemplu practic

 /watch https://youtu.be/dQw4w9wgccc Ce text apare pe ecran între 00:30 și 01:15?

Skill-ul descarcă clipul, extrage cadrele, obține transcriptul și Claude răspunde direct cu citate din subtitrări corelate cu imaginile.

Output / unde aterizează

Rezultatul aterizează în directorul temporar gestionat de skill (de obicei sub ~/.cache/watch sau echivalent). Claude primește lista de căi către fișierele JPEG și transcriptul complet. Tu vezi doar răspunsul final; fișierele intermediare rămân disponibile pentru inspecție manuală dacă este nevoie.

Limite / gotchas

  • Fără cheie Whisper, clipurile fără subtitrări native revin doar cu cadre (fără text).
  • Pe Windows înlocuiești python3 cu python – comanda python3 este stub-ul Microsoft Store și nu rulează scriptul.
  • Setup-ul rulează silențios la succes; nu anunța utilizatorul „setup complet” la fiecare apel.
  • Pentru detalii exacte despre flag-uri sau căi, verifică doctrina pentru detalii exacte din SKILL.md.

Graph View