Авторский скилл из полного доступа
youtube-download входит в подписку ClaudeBase. Файл скилла и инструкция по установке доступны подписчикам.
Что понадобится: yt-dlp версии 2025.05.22 или новее и ffmpeg; Node.js 22 или новее и git - один раз собрать сервер токенов; плагин и сервер bgutil-ytdlp-pot-provider (агент поставит по шагам из скилла); браузер, в котором вы вошли в YouTube.
Когда звать
- Когда нужно сохранить ролик, эфир или шортс с YouTube к себе, а yt-dlp падает с ошибкой 403.
- Когда скачанный вебинар вышел мыльным и мелкий текст на слайдах уже не разобрать.
Что делает
YouTube Download - наш скилл для Claude Code и Codex, который скачивает видео с YouTube по ссылке. Кидаешь агенту ссылку на ролик, прямой эфир или шортс и говоришь «скачай» - он сохраняет mp4 в нужную папку и называет путь и размер файла.
Главная беда при скачивании с YouTube - ошибка 403 и просьба «подтвердите, что вы не робот». Скилл обходит её через провайдер токенов: маленький локальный сервер, который выдаёт yt-dlp нужный YouTube токен. Обёртка ytget из скилла сама поднимает этот сервер, если он не запущен, и качает лучшее качество до 1080p.
Когда звать
- Нужно сохранить ролик, эфир или шортс к себе - для разбора, монтажа или расшифровки.
- yt-dlp падает с «HTTP Error 403» или «Sign in to confirm you’re not a bot».
- Скачанный вебинар или скринкаст вышел мыльным: разрешение нормальное, а текст на слайдах не прочитать.
- Файл получился слишком большим и его нужно ужать, не убив читаемость.
Чем отличается от «просто yt-dlp»
Голый yt-dlp в 2026 году на YouTube часто упирается в 403. Скилл собирает в одном месте то, что обычно ищут по форумам:
- Провайдер токенов. Сервер поднимается сам, агенту не нужно помнить, как его запускать.
- Слайды без мыла. Для вебинаров YouTube отдаёт поток с заниженным битрейтом. Скилл учит агента смотреть список форматов и брать поток с самым высоким битрейтом, обычно HLS, а потом проверять кадр из середины: читается ли мелкий текст.
- 403 при живом сервере. Отдельный рецепт на случай, когда токен есть, а поток всё равно отбивается: переход на HLS вместо смены кодеков наугад.
- Сжатие. Готовая команда ffmpeg, которая уменьшает вебинар примерно вдвое и сохраняет текст. Плюс предупреждение, какой настройкой файл, наоборот, раздувается.
- Починка. Проверка по четырём шагам, если снова 403: жив ли сервер, видит ли его yt-dlp, на месте ли плагин, собран ли сервер.
Что внутри
SKILL.md- порядок действий агента, установка, рецепты качества и сжатия, разбор поломок.scripts/ytget- обёртка: поднимает сервер токенов и скачивает ролик одной командой.yt-dlp-config.example- пример настроек yt-dlp: клиенты YouTube и cookies из вашего браузера.
Что нужно для работы
- yt-dlp версии 2025.05.22 или новее и ffmpeg. На Mac ставятся через Homebrew.
- Node.js 22 или новее и git - чтобы один раз собрать сервер токенов.
- Плагин и сервер bgutil-ytdlp-pot-provider - открытый проект Brainicism на GitHub, лицензия GPL-3.0. Как поставить и собрать, расписано в скилле по шагам, агент проведёт сам.
- Браузер, в котором вы вошли в YouTube. Из него yt-dlp берёт cookies, без них YouTube чаще просит доказать, что вы не робот.
Ключей и платных сервисов не нужно. Сжатие в скилле рассчитано на аппаратный кодек Mac, для Windows и Linux указана замена.
Скачивайте только то, на что есть право: свои ролики, видео с открытой лицензией, материалы для личного разбора.
Как получить
Скилл входит в полный доступ ClaudeBase. После установки Claude Code или Codex сам зовёт его, когда вы присылаете ссылку на YouTube и просите скачать. В первый раз агент проверит, что yt-dlp, ffmpeg и сервер токенов стоят, и поможет поставить недостающее.