К основному содержанию
скилл CX Codex

video-ingest — скилл для Claude Code: что делает и как установить

Скилл video-ingest забирает из видео транскрипт и визуальный ряд — демо, слайды, интерфейс — и кладёт это в контекст агента. Выбирает движок по задаче, доступным инструментам и длине ролика.

MIT ★ 33 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add chrono-meta/forge-harness --skill video-ingest -a claude-code
Открыть на GitHub

Что делает video-ingest

Если нужен только текст — например, доклад или интервью — скилл сразу берёт транскрипт через yt-dlp и не трогает визуальные движки: так дешевле. Если важна картинка на экране, он ищет мультимодальный движок: для длинных роликов — Gemini (через agy или Gemini API), который читает YouTube-ссылку напрямую и отдаёт и реплики, и то, что происходит на экране. Для коротких и средних видео, если такого движка нет, включается путь на ffmpeg: кадры вырезаются с ограничением по частоте и количеству, а дальше их читает собственное зрение Claude через Read.

У не-YouTube ссылок есть ограничение: произвольный поток без файла агент не может открыть в headless-режиме, это измеренный факт, а не предположение. Видео с ограниченным доступом скилл не обходит сам — он передаёт такую ссылку на отдельную сессию claude-in-chrome, залогиненную у оператора, но сам браузер не водит, потому что инструменты mcp__claude-in-chrome__* вне его allowed-tools. Прямой CLI gemini признан устаревшим (дата EOL 2026-06-18), поэтому рабочий маршрут ищется через agy или Gemini API.

Любой «комплексный» ответ мультимодального движка скилл не принимает на веру: он сверяет ключевые утверждения с транскриптом или повторным проходом по кадрам, и то, что не подтвердилось, помечает, а не выдаёт как факт. Результат — чистый текст, заметки по картинке (если был Tier 1) и метаданные — сохраняется по пути вида /tmp/yt_<id>_ingest.txt; загрузка этого текста в хранилище контекста — задача другого скилла.

Какие задачи решает

  • вытащить транскрипт из YouTube-видео
  • разобрать, что показано на экране в демо или на слайдах
  • получить описание видео, когда субтитров нет или они не нужны
  • проверить, что визуальный пересказ видео не врёт, сверив его с транскриптом
  • обработать видео с ограниченным доступом через залогиненную сессию браузера

Примеры запросов агенту

  • Прогони это видео через video-ingest и покажи транскрипт
  • Разбери, что показано на экране в этом видео: /video-ingest <URL>
  • Вытащи субтитры из этого YouTube-ролика через video-ingest

Как установить video-ingest

1Через Skills CLI (Vercel)

npx skills add chrono-meta/forge-harness --skill video-ingest -a claude-code

2Вручную: положить файлы

~/.claude/skills/video-ingest/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/video-ingest/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о video-ingest

Как установить video-ingest в Claude Code?

Выполните npx skills add chrono-meta/forge-harness --skill video-ingest -a claude-code — скилл появится в ~/.claude/skills/video-ingest/SKILL.md.

Что делает video-ingest?

Забирает из видео транскрипт и визуальный контент — демо, слайды, интерфейс — выбирая движок (Gemini, Claude-зрение через ffmpeg-кадры, yt-dlp или claude-in-chrome) по задаче, доступным инструментам и длине ролика. Результат с мультимодального прохода он дополнительно сверяет с транскриптом.

Почему для не-YouTube видео скилл иногда не срабатывает?

Произвольный (не-YouTube) поток недоступен в headless-режиме без загрузки файла — это измеренное ограничение, не предположение. В этом случае скилл деградирует до другого маршрута.

Исходный текст

SKILL.md · MIT
---
name: video-ingest
description: Ingests a video's content (YouTube and similar) for agent context, routing by capability, task need, and video length — a natively multimodal engine (Gemini via agy or the Gemini API) for direct-URL and long video, Claude vision over ffmpeg-extracted frames when no such engine is present, yt-dlp captions when the transcript alone suffices, and the logged-in claude-in-chrome session for auth-gated videos. The governor cross-checks any multimodal comprehensive-read. Triggered by "ingest this video", "what does this video show", "get the transcript from this YouTube video", "video-ingest".
user-invocable: true
allowed-tools: ["Read", "Bash"]
model: sonnet
---

# video-ingest — Video Content Ingestion (capability-routed)

A video carries two separable signals: the **spoken transcript** (text) and the **visual content**
(on-screen demos, slides, UI). Captions give only the first. So the route is chosen by **what the task
needs** × **what engine is available** × **video length** — not a single fixed path. This reuses
frontier-digest's capability-over-engine logic and adds on-demand, need-based routing, a Claude-native
frame path, output normalization, and a governance cross-check.

FH's increment over a raw video executor (sister asset `claude-video`, github bradautomates/claude-video;
cross-audit note in a private companion store): the executors *watch*; FH **governs** — the
governor never trusts a multimodal "comprehensive read" at face value, it cross-checks claims against the
transcript / a second pass. Same compose pattern as the other FH↔executor pairs.

## Triggers

- "ingest this video" · "what does this video show / demonstrate"
- "get the transcript from this YouTube video" · "pull the captions from <URL>"
- "summarize what's on screen in this video"
- "video-ingest"

## Step 0 — What does the task need? (picks the tier)

- **Video understanding** (visual: demos, UI walkthroughs, slides, anything not in the spoken words)
  → a vision path (Tier 1a or 1b below). Captions miss the screen.
- **Transcript only** (spoken words suffice — a talk, an interview) → go straight to **yt-dlp** (Tier 3);
  do not spend a vision engine when text is all that's needed (cost guard).

## Step 1 — Capability + length probe, then tier ladder (REUSE the probe — do not re-specify)

Resolve the engine by **capability, not name**, via frontier-digest's **Sidecar Engine Resolution
Protocol** (`plugins/fh-meta/skills/frontier-digest/SKILL_detail.md §Video-Harvest` — single source of
the probe commands). **Length is the 2nd axis** (claude-video is sparse past ~10min). The ladder:

- **Tier 1a — native multimodal, URL-direct (best for LONG video)**: an engine that watches the video and
  returns spoken + visual detail, no frame cap. Verified: **Gemini ingests a YouTube URL directly**
  (returns verbatim dialogue AND on-screen detail). Probe for a live route — the direct `gemini` CLI is
  EOL (2026-06-18), so probe `agy` / the Gemini API. **Caveat (measured)**: a *YouTube URL* works, but an
  **arbitrary (non-YouTube) stream is not reachable headless** (needs file upload) — degrade for those.
- **Tier 1b — Claude-native frame extraction (Claude-only; SHORT/MEDIUM ≤~10min)**: when no external
  multimodal engine is present, do not give up on visual content — `ffmpeg` extracts frames (auto-scaled,
  cap ~2fps/100 frames) → **Claude's own vision via Read** reads them as images (the claude-video
  pattern). No separate runtime, **no Gemini-EOL exposure**. Caution: claude-video itself is a 3rd-party
  executable (brew installs + optional Whisper egress) — if invoking it directly, review first; the
  ffmpeg+Read mechanism can also be run inline without it.
- **Never route video to a coding-agent CLI** (codex, a non-multimodal model) — burns tokens, recovers
  only metadata.
- **Tier 3 — yt-dlp transcript** (text only; conditional — probe first, never assume):
  ```bash
  yt-dlp --no-update --skip-download --write-auto-subs --sub-langs en \
    --sub-format json3 -o "/tmp/yt_%(id)s.%(ext)s" "<URL>"
  python3 -c "import json,sys,re;d=json.load(open(sys.argv[1]));print(re.sub(r'\s+',' ',' '.join(s.get('utf8','') for e in d['events'] for s in e.get('segs',[]) if s.get('utf8','').strip())).strip())" /tmp/yt_<id>.en.json3
  ```
  `--write-subs` (human captions) preferred when present. Keep yt-dlp current (`pip install -U yt-dlp`;
  version/impersonation warnings are non-blocking). yt-dlp also supplies the transcript the governor
  cross-checks a Tier-1 visual read against.
- **Auth-gated** (members-only / age-gated) → **claude-in-chrome** (operator's logged-in session).
  video-ingest **surfaces this route as a handoff** — it does not drive the browser itself (the
  `mcp__claude-in-chrome__*` tools are outside this skill's `allowed-tools`). Caveat: needs the Anthropic
  "direct" plan — unavailable on a corp Bedrock laptop; surface the limit, do not loop.
- **Unresolvable** (no vision engine, yt-dlp probe fails, not auth-fixable) → operator summary remains the
  path; say so plainly.

## Step 1.5 — Governance cross-check (FH's increment; do not skip on a multimodal read)

A Tier-1 engine's "comprehensive read" is a **self-report**, untrusted like any sidecar output. The
governor cross-checks its key claims against the transcript (Tier 3) or a second targeted frame pass
before accepting; a visual claim that contradicts the transcript or cannot be re-grounded is flagged, not
relayed as fact. (This is the governance claude-video has no equivalent for.)

## Step 2 — Normalize + hand off

Write clean text (+ visual notes if Tier 1) and metadata (video id, title, duration, source: multimodal
vs transcript, caption type human/auto) to a predictable path (`/tmp/yt_<id>_ingest.txt` or a
caller-specified path). Downstream grounding ingest is `corpus-grounding-expander`'s job — video-ingest
produces the artifact, it does not ingest into a store.

## Done When

- Output artifact written AND character count > 0 (or a specific failure reason surfaced). *[measured]*
- Tier chosen matches the task need × the live capability probe × length (video-understanding → Tier 1a
  for long / Tier 1b for short-medium; transcript-only → yt-dlp). *[judged, pair: the probe is the
  mechanical anchor]*
- A Tier-1 multimodal comprehensive-read was cross-checked against the transcript / a second pass before
  its claims were relayed as fact. *[judged, pair: transcript diff is the mechanical anchor]*
- On failure, a specific reason is surfaced (no-captions / auth-required / no-vision-engine /
  arbitrary-stream-headless-unreachable) — never a silent empty result. *[mandatory-pass]*

## Guards

- **No-reinvention** — the capability probe + tier ladder are frontier-digest's Sidecar Engine Resolution
  Protocol (single source); the executors are yt-dlp (Bash), the Gemini path, ffmpeg+Read (claude-video
  pattern), and claude-in-chrome (MCP). This skill routes by need × length, cross-checks, normalizes, and
  reports — it builds no caption engine, no frame extractor, no browser automation.
- **Governor never trusts a multimodal self-report** — Step 1.5 cross-check is FH's increment over a raw
  video executor; a visual claim is grounded before it is relayed.
- **Capability over engine name** — probe what an engine can actually do (EOL/availability drifts);
  never assume `gemini`/`agy`/`yt-dlp`/`ffmpeg` is present.
- **Cost guard** — transcript-only need never spends a vision engine.
- **3rd-party executable caution** — claude-video (brew installs + optional Whisper egress) is reviewed
  before install; the ffmpeg+Read mechanism can run inline without adopting the whole tool.
- **Corp-host honesty** — when a path is unavailable (Bedrock laptop, EOL CLI, headless-stream limit),
  state it; do not loop on a path that cannot run.

© chrono-meta · MIT · chrono-meta/forge-harness

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
watch bradautomates Скилл watch смотрит видео по URL или локальному пути, собирает кадры и расшифровку, чтобы агент отвечал на вопросы о содержимом. Подходит для разбора роликов прямо из IDE. CX Codex +1 19 300установок video-transcript-downloader steipete Скилл video-transcript-downloader для Claude Code и Codex: достаёт транскрипт из видео одной командой и скачивает видео, аудио или субтитры через yt-dlp. Доклад читается быстрее, чем смотрится. CX Codex +1 1 100установок c-video daxaur Скилл c-video для Claude Code помогает скачивать видео и извлекать аудиодорожки через yt-dlp и ffmpeg. Обрабатывает медиа из командной строки. CX Codex +1 ★ 179звёзд репо video-summarizer liang121 Скилл video-summarizer скачивает видео и аудио с веб-сайтов через yt-dlp, извлекает субтитры или распознаёт речь через faster-whisper и собирает текстовое саммари. CX Codex +1 539установок Video Transcriber nhatvu148 MCP-сервер Video Transcriber расшифровывает видео со сторонних площадок и локальные файлы через whisper.cpp, работая офлайн. Полезно, когда нужно вытащить текст из ролика прямо в чате с агентом. CX Codex +1 ★ 20звёзд репо video-analysis Starchild-ai-agent Скилл video-analysis разбирает видеофайлы через прямое чтение мультимодальной моделью или нарезку кадров с транскрипцией речи. CX Codex +1 1 800установок

Из того же набора41

Весь набор →
qp Скилл qp проводит приложение через планирование тестов, запуск и проверку регрессий. Подходит для QA веб-сайта или десктопного приложения из сессии Claude Code. CX Codex +1 ★ 33звёзд репо qp-run Скилл qp-run для Claude Code выполняет тест-кейсы из qp-plan на работающем приложении через адаптер сессии и записывает приговоры по шагам в TSV. CX Codex +1 ★ 33звёзд репо qp-regress Скилл qp-regress для Claude Code повторно прогоняет тест-кейсы без правок, проверяет выход за пределы стартового экрана и строит дельту по каждому тесту. Включается на этапе регрессионного тестирования. CX Codex +1 ★ 33звёзд репо qp-plan Скилл qp-plan для Claude Code, который готовит поверхность приложения к тестированию: составляет инвентарь экранов, проверяет его на пропуски и дубли, проектирует тест-кейсы. CX Codex +1 ★ 33звёзд репо verify-bidirectional Скилл verify-bidirectional для Claude Code перепроверяет рекомендацию ИИ после возражения пользователя. Он ищет расхождения с прежними решениями и обновляет постоянные правила только при наличии подтверждения. CX Codex +1 ★ 33звёзд репо sim-conductor Скилл sim-conductor для Claude Code запускает симуляции реакций пользователей, аудиты и проверки качества. Он подключает параллельных агентов после анализа целевого файла. CX Codex +1 ★ 33звёзд репо salience-splitter Скилл salience-splitter для Claude Code и других агентов делит always-loaded контекст на постоянный слой и слой по запросу. Критерий — когда нужен контент, а не его длина. CX Codex +1 ★ 33звёзд репо return-path-gate Скилл return-path-gate для Claude Code сканирует SKILL.md в plugins/ и выявляет fire-and-forget цепочки. Классифицирует их как CLOSED или OPEN и даёт рекомендации по закрытию. CX Codex +1 ★ 33звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой