ffmpeg-skill — 42 локальных инструмента FFmpeg для ИИ-агентов

ffmpeg-skill — открытый набор инструментов, который подключает видеомонтаж на базе FFmpeg к Claude Code, Cursor, Codex и другим ИИ-агентам. Вместо длинных команд для терминала агент получает 42 операции с понятными параметрами: от анализа и обрезки ролика до субтитров, обработки звука и проверки готового файла.

Видеофайлы обрабатываются на компьютере пользователя: проект вызывает локальные FFmpeg и ffprobe и не требует API-ключа или облачного сервиса для самого монтажа. При этом запросы к облачному ИИ-агенту по-прежнему проходят через его поставщика. Репозиторий доступен на GitHub под лицензией MIT.

Что умеет ffmpeg-skill

Монтаж, обрезка и подготовка формата

Инструменты позволяют вырезать один или несколько фрагментов, соединять ролики, менять продолжительность и кадрировать видео под нужное соотношение сторон. Можно подготовить вертикальный вариант 9:16 для Reels, TikTok или Shorts, добавить поля либо выбрать обрезку. Если перекодирование не требуется, некоторые операции сначала пытаются сохранить исходные потоки без потери качества.

Кроме базового монтажа, доступны обнаружение сцен и пауз, удаление тишины, стабилизация, шумоподавление, исправление наклона, работа с замедлением и ускорением, вставка изображения и сборка видео из последовательности кадров. Удаление слов-паразитов возможно только при наличии локального распознавателя речи и временных отметок; сам ffmpeg-skill не угадывает, какие слова нужно вырезать.

Субтитры, звук и оформление

Субтитры можно взять из файлов SRT или ASS либо подготовить по уже размеченному тексту. Инструмент размещает строки с учётом безопасных зон выбранной платформы. Для автоматической расшифровки потребуется отдельно установленный движок распознавания речи; это необязательная функция.

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

Как агент выполняет задачу и проверяет результат

Сначала изучает файл, затем монтирует

Рабочий процесс начинается с анализа исходного видео: длительности, разрешения, частоты кадров, цветовых параметров и аудиодорожек. Агент выбирает подходящие операции, а для большинства инструментов может сначала показать план без записи файла. Оригинал не перезаписывается автоматически: результат сохраняется отдельно, а замену существующего файла нужно явно разрешить.

Проверка готового ролика

После обработки ffmpeg-skill повторно анализирует результат и может проверить его соответствие параметрам площадки. Если изменилось изображение, инструмент создаёт контактный лист или отдельные кадры. Визуально оценить их должен сам мультимодальный агент: FFmpeg не определяет самостоятельно, удачно ли выбран момент, сохранилось ли лицо в кадре или правильно ли легли субтитры.

Экспортные шаблоны предусмотрены для Reels, TikTok, YouTube Shorts, YouTube, X, LinkedIn, Facebook и подкастов. Они задают технические параметры и безопасные области интерфейса, но не заменяют редакторское решение о содержании ролика.

Установка и требования

Подключение к Claude Code, Cursor или Codex

Вариант установки зависит от агента. Для Codex используйте флаг --codex, для Cursor — --cursor, а для установки во все три среды — --all. После установки команда doctor проверяет, доступны ли FFmpeg, ffprobe и нужные фильтры в системе.

npx ffmpeg-skill --all
npx ffmpeg-skill doctor

Для работы требуются Node.js для установки через npx, Python 3.9 или новее и установленный FFmpeg. Состав FFmpeg различается между сборками: например, рендеринг субтитров и текста требует соответствующих фильтров. Проверка doctor показывает, какие функции доступны на конкретном компьютере. Если Node.js не установлен, репозиторий можно скопировать вручную; для доступа через другие MCP-клиенты предусмотрен MCP-сервер.

Кому подойдёт этот инструмент

ffmpeg-skill полезен авторам видео, небольшим продакшен-командам и разработчикам, которые хотят поручать повторяющиеся операции ИИ-агенту, но сохранять файлы на собственной машине. Он особенно удобен для серийной подготовки роликов под разные площадки, пакетной обработки материалов и локального монтажа без передачи исходного видео в облачный редактор.

Это не самостоятельный видеоредактор с графическим интерфейсом и не модель, которая сама придумывает сценарий или выбирает лучшие моменты. ffmpeg-skill предоставляет агенту проверяемые операции FFmpeg; выбор кадров, текста, смысла и удачного монтажа остаётся за пользователем и выбранным ИИ-агентом. Подробности и исходный код — в репозитории ffmpeg-skill на GitHub.