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

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

Скилл video-edit для Claude Code монтирует видео на таймлайне и накладывает звук, титры и переходы. Срабатывает при сборке роликов, добавлении фоновой музыки или смене соотношения сторон.

MIT 177 установок ★ 152 обновлён 2026-09-11

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

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

Скилл собирает видео на таймлайне с дорожками, накладывает фоновую музыку, дикторский голос, логотипы, текст и караоке-субтитры. Локальный рендеринг через FFmpeg или MoviePy не используется: обработка идёт на серверах VideoDB.

В Claude Code монтаж выполняется через библиотеку videodb на Python. Доступна генерация музыки, синтез речи и дубляж видео на другие языки. Для запуска нужен бесплатный ключ VIDEO_DB_API_KEY в файле .env.

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

  • наложить фоновую музыку или дикторскую дорожку
  • добавить анимированные караоке-субтитры поверх видео
  • объединить несколько роликов с плавными переходами
  • изменить разрешение или ориентацию кадра под соцсети

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

  • Собери ролик из clip1.mp4 и clip2.mp4 с плавным переходом и титрами
  • Добавь тихую фоновую музыку и анимированные субтитры к видео
  • Измени соотношение сторон видео на вертикальное 1080x1920

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

1Через Skills CLI (Vercel)

npx skills add video-db/skills --skill video-edit -a claude-code

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

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

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

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

Вопросы о video-edit

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

Выполните команду npx skills add video-db/skills --skill video-edit -a claude-code.

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

Монтирует видеодорожки, добавляет фоновый звук, графику и анимированные титры на удалённых серверах VideoDB.

Что нужно для работы video-edit?

Требуется ключ API сервиса VideoDB в переменной VIDEO_DB_API_KEY и установленный пакет videodb.

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

SKILL.md · MIT
---
name: video-edit
description: Edit and compose video on a timeline. Use when the user wants to add background music, a voiceover or another audio track, put text, a logo or an image overlay on a video, join several videos or images into one with fades or other transitions, add animated or word-by-word karaoke captions, change the resolution or aspect ratio of a composition, or generate music, voiceover, images or video with AI for a composition. Static subtitles with a chosen font and position belong to video-subtitles.
---

# Edit and compose

## Which path

1. **VideoDB connector tools present** (names such as `render_timeline`, `upload_media`, `download_timeline_render`): use them. This is the path in Claude chat on web, desktop and mobile, and in Cowork. Do not install anything and do not ask for an API key.
2. **No VideoDB tools, but you have a shell** (Claude Code, Cowork, any agent that can run Python): ask for the VideoDB API key in one friendly line (free at https://console.videodb.io, $20 of credits, no card). When the user gives it, in chat or any other way, save it yourself to the project's `.env` as `VIDEO_DB_API_KEY`, never print it, and continue with the Python SDK path at the end of this file. In Claude Code, `/mcp` then authorizing videodb also works.
3. **No VideoDB tools and no shell**: you are in Claude chat. Reply with only this, adapted to the request: "VideoDB isn't connected yet. Open Settings → Connectors, find VideoDB, click Connect and log in (free, no card). Then send this request again and I'll take it from there." Do not mention API keys, `.env`, shells, Claude Code or `/mcp` here; none of them apply in chat, and a key pasted into chat cannot be used because nothing runs code there.

Talking to the user: never write "index", "indexed" or "indexing" in a reply. Say "searchable" ("it is now searchable by what was said and what is shown"), and "transcribe" rather than naming a job. One line of status at a time, then the result.

Rendering is a long job: the call returns `status: processing`. The reply carries an `output_url` and names the tool to poll (`poll_with`, or `retry_with` on older servers). Call that tool with the `output_url` until it is `done`; several `processing` replies in a row are normal (a 10-minute YouTube upload takes about five), and a `done` reply with an empty result means poll once more. Never re-run the write; that starts a second job. Share the finished `player_url`.

Do not fall back to ffmpeg, moviepy or local encoding for anything below; it all runs on VideoDB's servers.

## With the connector tools

**Assets first.** Every piece of media needs a VideoDB id: videos `m-`, audio `a-`, images `img-`. `upload_media(url)` takes a public URL or YouTube link (`media_type="audio"` for a music file, `"image"` for a logo). `list_videos`, `list_audios`, `list_images` show what is already there. Local files cannot come through the connector; the user uploads at https://console.videodb.io.

**One call composes everything:** `render_timeline(tracks=[...], resolution="1920x1080", background="#000000")`. Each track holds clips; each clip has `start` (seconds on the timeline), `duration`, and an `asset`. Tracks stack by `z_index` (higher on top).

| The user wants | Asset in the clip |
|---|---|
| A video, from second 10 of the source | `{"type": "video", "id": "m-...", "start": 10, "volume": 1}` |
| Background music at 20% | `{"type": "audio", "id": "a-...", "volume": 0.2}` on its own track |
| A title or lower-third | `{"type": "text", "text": "Launch day", "font": {"size": 64, "color": "#FFFFFF"}, "background": {"color": "#000000", "opacity": 0.6, "border_width": 12}}` with clip `fit: "contain"` and `position: "bottom"` |
| A logo or image | `{"type": "image", "id": "img-..."}` with clip `scale: 0.2`, `position: "top_right"`, `opacity: 0.9` |
| Captions from speech | `{"type": "caption", "src": "auto", "animation": "box_highlight"}`; the video must already be transcribed (`generate_transcript`, or a `spoken_words` analyzer run) or the render shows no captions and no error |
| A fade between clips | clip `transition: {"in": "fade", "out": "fade", "duration": 0.5}` |
| Vertical for social | `resolution="1080x1920"`, clip `fit: "crop"` |

Text assets: `width` and `height` are honoured only with `fit: "contain"`; the default `crop` scales the text box up to fill the frame.

Example, a 20-second clip with a title and quiet music:

```
render_timeline(resolution="1920x1080", tracks=[
  {"z_index": 0, "clips": [{"start": 0, "duration": 20, "asset": {"type": "video", "id": "m-abc", "start": 30}}]},
  {"z_index": 1, "clips": [{"start": 0, "duration": 4, "fit": "contain", "position": "bottom",
                            "transition": {"in": "fade", "out": "fade"},
                            "asset": {"type": "text", "text": "Launch day", "font": {"size": 64}}}]},
  {"z_index": 0, "clips": [{"start": 0, "duration": 20, "asset": {"type": "audio", "id": "a-xyz", "volume": 0.2}}]}
])
```

**An MP4 file:** `download_timeline_render(stream_url)`, poll, share the download URL.

**Generating music, voiceover, images or video with AI, and dubbing:** not available through the connector. In Claude Code the SDK does it (below). In chat, ask the user for a hosted audio or image URL to upload instead, and say that generation needs Claude Code or the SDK.

## With the Python SDK (Claude Code)

Set up first with `/videodb:setup` if `import videodb` fails. Full guide: `${CLAUDE_PLUGIN_ROOT}/python/reference/editor.md`; generation: `${CLAUDE_PLUGIN_ROOT}/python/reference/generative.md`.

```python
from dotenv import load_dotenv; load_dotenv(".env")
import videodb
from videodb.editor import Timeline, Track, Clip, VideoAsset, AudioAsset, TextAsset, Fit, Transition
conn = videodb.connect(); coll = conn.get_collection()
video = coll.upload(url="https://www.youtube.com/watch?v=VIDEO_ID")
music = coll.generate_music(prompt="warm acoustic background", duration=20)   # or coll.upload(url=..., media_type="audio")
voice = coll.generate_voice(text="Welcome to the show", voice_name="Default")
timeline = Timeline(conn); timeline.resolution = "1920x1080"
v = Track(); v.add_clip(0, Clip(asset=VideoAsset(id=video.id, start=30), duration=20))
a = Track(); a.add_clip(0, Clip(asset=AudioAsset(id=music.id, volume=0.2), duration=20))
timeline.add_track(v); timeline.add_track(a)
stream_url = timeline.generate_stream()
print(f"https://console.videodb.io/player?url={stream_url}")
```

Dubbing: `coll.dub_video(video.id, language_code="es")`.

© video-db · MIT · video-db/skills

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

Все скиллы по теме «ИИ и ML» →

Сначала — video-edit от других авторов.

video-edit prime-skills Скилл video-edit для Claude Code выбирает модель RunComfy для рестайлинга видео, замены фона, дизайна упаковки или переноса движения. Для разных задач выбираются разные маршруты. CX Codex +1 450 700установок video-edit calesthio Скилл video-edit для Claude Code обрабатывает локальные видеофайлы через ffmpeg: нарезает ролики, меняет пропорции под соцсети и сжимает дорожки. CX Codex +1 1 600установок video-edit 0xSero Скилл video-edit для Claude Code собирает из записи экрана, OBS или разговора готовое видео. Убирает паузы и утечки, обрабатывает звук и готовит материалы для публикации. CX Codex +1 ★ 92звёзд репо video-edit YildizDikme Скилл video-edit для Claude Code монтирует видео с речью: нарезает исходные дубли, добавляет графику и звуковые эффекты. Подключается для подготовки ролика от исходников до финального рендера. CX Codex +1 ★ 57звёзд репо video-edit hoodini Скилл video-edit превращает запись в ролик с субтитрами: распознаёт речь, даёт поправить текст до рендера и собирает 16:9 или 9:16 из одного файла. CX Codex +1 ★ 301звёзд репо video-understand calesthio Скилл video-understand для Claude Code, Codex, Cursor и других агентов: извлекает кадры через ffmpeg и расшифровывает речь через Whisper прямо на машине. Работает без интернета и без внешних ключей. CX Codex +1 1 500установок edit-timeline-studio MartinDelophy Скилл edit-timeline-studio для Claude Code и Codex помогает редактировать проекты Timeline Studio и экспортировать видео. Разбирает локальные медиа, планирует монтаж и сохраняет редактируемую временную шкалу. CX Codex +1 ★ 1 002звёзд репо open-edit veedstudio Скилл open-edit для Claude Code создаёт и редактирует видео через сервисы VEED и CLI. Он запускается, когда агенту нужно собрать ролик, монтаж или субтитры. CX Codex +1 1 400установок layer-video-timeline layerai Скилл layer-video-timeline для Claude Code собирает готовые клипы, картинки и аудио в ролик с порядком, переходами, титрами, логотипом и музыкой. CX Codex +1 4 900установок layer-video-looks layerai Скилл layer-video-looks для Claude Code настраивает единую стилизацию, фильтры и хромакей на таймлайне Layer. Включается при сборке видео, когда нужно подогнать шоты по цвету или наложить ретро-эффект. CX Codex +1 1 100установок fal-video-edit nexu-io Скилл fal-video-edit для Claude Code меняет стиль существующего видео, повышает разрешение, удаляет фон и добавляет аудио с помощью моделей fal.ai. Агент редактирует готовые ролики. CX Codex +1 2 900установок

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

videodb Настраивает VideoDB и пишет код через Python SDK. Запускается при массовой загрузке или индексации медиатеки, написании скриптов и ноутбуков. CX Codex +1 1 700установок video-subtitles Скилл video-subtitles для Claude Code создаёт расшифровки, переводит субтитры и добавляет их к видео. Запускается для видео, подкастов и записей звонков. CX Codex +1 183установок video-search Скилл video-search для анализа видео, поиска моментов по описанию и извлечения клипов в Claude Code и других средах. Находит нужные фрагменты в записях встреч или загруженных материалах. CX Codex +1 183установок video-clips Скилл video-clips для Claude Code нарезает фрагменты видео и собирает хайлайты по запросу. Он включается для клипов по таймкодам, вертикальных роликов и миниатюр. CX Codex +1 182установок VideoDB MCP-сервер VideoDB для Claude Code подключает удалённую обработку роликов к чату с агентом. Обрабатывает публичные ссылки и YouTube без загрузки тяжёлых файлов на компьютер. CX Codex +1 ★ 152звёзд репо

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

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