---
name: using-yt-tools
version: 0.1.0
description: Use when the agent needs to "watch" a YouTube video iteratively — fetch a clean-markdown transcript with [mm:ss] anchors, decide which moments matter, then pull only those frames as JPGs for vision-reading via Read. Triggers on "транскрипт видео", "расшифровка YouTube", "что в этом ролике", "о чём ролик", "покажи кадр на N", "посмотри момент N", "что показано в видео на N", "watch this video", "video summary", "youtube transcript", or any youtube.com URL where WebFetch can't reach the actual content. Wraps yt-dlp + youtube-transcript-api + PySceneDetect + ffmpeg via CLI in `~/projects/.common/lib/yt-tools/`. Skip for non-YouTube videos (Vimeo/Twitch/local mp4), audio-only podcasts (no STT here), or pure-download workflows (use yt-dlp directly).
---

# using-yt-tools

Iterative-watching YouTube для агента: clean-markdown транскрипт с `[mm:ss]`-якорями → агент решает, какие моменты интересны → targeted frame extraction по таймкодам → агент видит кадры через `Read`.

## When to use

<пусто, дописывается во втором проходе>

## Inputs

<пусто>

## Steps

<пусто>

## Failure modes

<пусто>

## Side effects

<пусто>

## What NOT to do

<пусто>