FFmpeg-skill: агентский скилл с проверенными рецептами для работы с видео и аудио

FFmpeg — инструмент могучий, но коварный: почти у каждой команды есть полдюжины способов написать её неправильно, и лишь один — правильно. Скилл FFmpeg Agent Skill от n0an решает эту проблему элегантно: он превращает категоризированную шпаргалку проверенных FFmpeg-рецептов в справочник, который AI-агент подгружает по запросу, вместо того чтобы вспоминать команды по памяти — там, где легко ошибиться в порядке флагов.

Скилл оформлен в формате Agent Skills, поэтому одинаково хорошо работает с Claude Code, Codex, Gemini, Cursor и другими агентами. По сути это единый скилл FFmpeg Recipes: вместо того чтобы агент генерировал команду с нуля, он берёт ближайший рецепт из справочных файлов, адаптирует входные данные и параметры — и выдаёт готовую однострочную команду с пояснением неочевидных флагов.

Что внутри

Рецепты сгруппированы по задачам, с которыми чаще всего сталкиваются при работе с видео и аудио:

• Конвертация форматов — remux MP4 / MKV / MOV, кодирование в AVI, смена контейнера без перекодирования.
• Масштабирование и леттербоксинг — масштабирование с сохранением пропорций и паддингом под вертикальные и горизонтальные целевые разрешения.
• Обрезка и сикинг — покадрово точный output seeking против быстрого, но неточного input seeking по ключевых кадрам.
• Обработка аудио — замена, извлечение, микширование, кроссфейд, нормализация, понижение частоты дискретизации, стерео в моно.
• Продвинутое редактирование — изменение скорости воспроизведения без сдвига высоты тона, jump-каты, оверлеи через drawtext, вжигание субтитров, водяные знаки, вертикальная склейка через vstack, сборка интро/основная часть/аутро.
• Генерация ассетов — изображение в видео, слайдшоу с переходами xfade, эффект Ken Burns через zoompan, зацикленные GIF, миниатюры по смене сцен, плиточные сториборды.
• Кодирование и тюнинг — шаблон libx264 на каждый день, руководство по CRF, libx265 с тегом hvc1 для Apple, libvpx-vp9 для веба, флаг +faststart, аппаратное транскодирование (h264_nvenc, h264_qsv, VAAPI).
• Глоссарий — синтаксис флагов и фильтров, селекторы потоков ([0:v], [1:a]), -map, правила -c copy, setpts / asetpts, вычисление выражений.

Отдельная деталь, которую оценят все, кто когда-нибудь собирал тестовые команды FFmpeg: примеры URL в справочниках указывают на storage.rendi.dev, поэтому команды можно запускать сразу, не подготавливая локальные файлы.

Зачем агенту скилл, если он «и так знает» FFmpeg

FFmpeg печально известен тем, что в нём легко ошибиться неочевидными способами. Авторы скилла приводят характерные примеры:

• Флаг -ss, поставленный до -i, даёт быструю, но приблизительную обрезку; после — медленную, но покадрово точную. Перепутать порядок — и результат совершенно другой.
• Пропущенный -pix_fmt yuv420p делает вывод невоспроизводимым в QuickTime, хотя в VLC файл воспроизводится совершенно нормально.
• Забытый setpts=PTS-STARTPTS после фильтра trim молча ломает последующую склейку через concat.
• Отсутствие -vtag hvc1 приводит к тому, что HEVC-файлы не открываются через AirDrop на iOS.

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

Установка

Основной способ — через npx, работает для Claude Code, Codex, Gemini, Cursor и других агентов:

npx skills add https://github.com/n0an/ffmpeg-skill --skill ffmpeg

Если получаете ошибку npx: command not found, значит Node не установлен. Установите его через Homebrew:

brew install node

Если не сработало и это — вероятно, сначала нужно установить сам Homebrew с brew.sh.

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

Альтернативные способы установки

Для Claude Code:

/plugin install n0an/ffmpeg-skill

Для Gemini:

gemini extensions install https://github.com/n0an/ffmpeg-skill.git --consent

Ну и классика: можно просто склонировать весь репозиторий и установить скилл любым удобным способом.

Как пользоваться

Скилл называется FFmpeg Recipes и вызывается по-разному в зависимости от агента. В Claude Code:

/ffmpeg

В Codex:

$ffmpeg

В обоих случаях можно сразу передать конкретную инструкцию:

/ffmpeg crop this 1080p clip to a 9:16 vertical for Shorts and burn captions on top
$ffmpeg shrink this MP4 for upload to a 25 MB Slack limit

Работает и вызов обычным языком, без слэша:

Use the FFmpeg skill to convert this MOV to a web-optimized MP4 with faststart.

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

Откуда рецепты

Материал скилла адаптирован из Rendi FFmpeg cheatsheet команды Rendi — большой общедоступной шпаргалки по FFmpeg. Авторы реструктурировали её в справочные файлы, которые агент загружает по мере необходимости: компактный вход в скилл, подробности по требованию. Такой подход экономит токены — файлы с деталями не попадают в контекст, пока не понадобятся.

Контрибьюция и лицензия

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

• Держите Markdown кратким — у скиллов есть цена в токенах, уважайте бюджеты пользователей.
• Предпочитайте однострочные команды с коротким пояснением многошаговым shell-скриптам.
• Замечайте причуды FFmpeg (открытые баги, совместимость кодеков, ограничения контейнеров) прямо рядом с рецептом, которого они касаются.
• Весь код должен распространяться под лицензией MIT.

Проект доступен под MIT License — коммерческое использование, модификация и распространение разрешены.

Кому подойдёт

Скилл стоит поставить, если вы регулярно имеете дело с медиафайлами в разработке: сжимаете записи встреч для отправки в мессенджеры, готовите вертикальные клипы для Shorts и Reels, вжигаете субтитры, собираете слайдшоу, генерируете превью или встраиваете обработку видео в скрипты. Вместо того чтобы каждый раз гуглить «ffmpeg обрезать видео без потери качества» и молиться, что скопированная команда учла все нюансы, вы описываете задачу агенту — и получаете корректную команду с объяснением.