# videodb

Даёт агенту зрение и слух на видео: индексирует речь и сцены, ищет моменты с таймкодами, режет клипы, правит таймлайн и следит за RTSP-потоками.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1500 установок · ★ 139
- Автор: video-db
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/video-db/skills/tree/HEAD/python/SKILL.md
- Обновлён: 2026-09-11
- HTML: https://affpapa.org/nevibecode/skills/video-db-videodb

## Что делает

Скилл подключает к агенту SDK VideoDB: файл, публичная ссылка или RTSP-поток загружаются в коллекцию и возвращаются как играбельная ссылка на стрим. Дальше поверх видео запускаются анализаторы — распознавание речи, описание сцен, объекты, OCR, бренды, активность. Результаты складываются в индексы, по которым можно искать моменты, задавать вопросы и фильтровать с таймкодами и ссылками на доказательства в самом видео.

Правки идут через операции таймлайна: субтитры с переводом и вшиванием в кадр, текстовые и графические оверлеи, фоновая музыка, озвучка. Отдельный блок — запись рабочего стола со экраном, микрофоном и системным звуком, сводка сессии и алерты по тому, что происходит на экране или сказано вслух.

Для работы нужен ключ `VIDEO_DB_API_KEY`: `videodb.connect()` читает его из окружения или из `.env` в каталоге проекта, поэтому Python-код запускайте уже внутри проекта. Ставьте SDK с экстрой capture — на Linux она может не собраться, тогда ставьте без неё. Версия не ниже 0.5.0 обязательна: в более ранних нет understand/index/ask/aggregate. Хуже того, прогон с упавшим анализатором висит в статусе `partial`, и `wait_until_complete()` дотянет до `TimeoutError` — опрашивать надо сами анализаторы.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add video-db/skills --skill videodb -a claude-code
```
```bash
npx skills add video-db/skills --skill python -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/python/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/python/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add video-db/skills --skill python -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/python/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add video-db/skills --skill python -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/python/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install video-db/skills python
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/python/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add video-db/skills --skill python -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/video-db/skills --path python
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/python/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add video-db/skills --skill python -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/video-db/skills/tree/HEAD/python/SKILL.md

## Когда брать
- найти в длинной записи все моменты, где в кадре есть люди, и получить таймкоды
- сделать видео играбельным по ссылке без своего плеера
- сгенерировать субтитры, перевести их и вшить в кадр
- получать алерт, когда в зону RTSP-камеры входит человек
- записать сессию рабочего стола и получить по ней разбор с таймлайном

## Примеры запросов агенту
- Загрузи этот файл в VideoDB и верни ссылку на стрим.
- Проиндексируй папку и найди все сцены с людьми, покажи таймкоды.
- Сгенерируй субтитры, вшей их и добавь тихую фоновую музыку.

## Похожие
- [skill-creator](https://affpapa.org/nevibecode/skills/skill-creator.md) — скилл · 414180 установок
- [writing-for-agents](https://affpapa.org/nevibecode/skills/writing-for-agents.md) — скилл · 466719 установок
- [media-use](https://affpapa.org/nevibecode/skills/media-use.md) — скилл · 1100000 установок
- [mcp-builder](https://affpapa.org/nevibecode/skills/mcp-builder.md) — скилл · 130949 установок
- [subagent-driven-development](https://affpapa.org/nevibecode/skills/subagent-driven-development.md) — скилл · 237746 установок
- [orchestration](https://affpapa.org/nevibecode/skills/orchestration.md) — скилл · 349800 установок

## Другие версии с тем же именем
- [videodb · affaan-m](https://affpapa.org/nevibecode/skills/videodb.md) — 4500 установок

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md