hyperframes-video-generation-skill

Скилл для ИИ-агентов (OpenCode, Claude Code и др.): полный цикл создания видео с озвучкой — от изучения источника и сценария до TTS-озвучки, HTML-анимации и готового MP4.

Генерирует обучающие эксплейнеры, видео по книгам (сюжет, смысл, мораль), обзоры, промо, отчёты и сторителлинг. Вход — файл (md/txt/pdf), текст, ссылка или просто тема. Выход — готовый MP4 с озвучкой (русской по умолчанию), фоновой музыкой и современной моушн-графикой.

Возможности

• Сценарий и раскадровка из источника (файл, текст, тема — фактура собирается из интернета), с тремя обязательными точками ревизии с пользователем
• Озвучка бесплатным edge-tts (без API-ключей): десятки голосов, per-scene MP3 + SRT, поддержка подкаст-диалогов двумя и более голосами
• Анимация на HTML + GSAP через hyperframes: 15+ проверенных сцен-архетипов, 4 пресета стиля, забандленные шрифты с кириллицей (Unbounded, Manrope, JetBrains Mono)
• Фоновая музыка с автоподбором из свободных источников (Mixkit → Incompetech → FMA → Internet Archive → Wikimedia Commons), обрезка и фейды под длительность
• Проверка результата: ffprobe, баланс голос/музыка, контрольные кадры из готового MP4
• Полностью автономен; если установлены скиллы hyperframes-* / media-use, подключает их как опциональные усилители

Требования

• macOS (Apple Silicon или Intel). Homebrew не нужен для установки в проект — только для глобального варианта
• На чистом Mac: xcode-select --install (даёт git, curl, python3) — этого достаточно
• Node.js ≥ 22, ffmpeg, edge-tts, yt-dlp — если их нет глобально, bootstrap ставит локальные копии в папку проекта (.tools/), система не трогается

Установка

В папку проекта (по умолчанию)

Выполняется из рабочей папки проекта (откуда запускается сессия агента). Скилл, скиллы hyperframes и всё недостающее ПО ставятся локально в проект:

cd <папка-проекта>
git clone https://github.com/vokasug/hyperframes-video-generation-skill \
  .agents/skills/hyperframes-video-generation
bash .agents/skills/hyperframes-video-generation/scripts/bootstrap.sh --install

Bootstrap положит недостающее ПО (node, ffmpeg, edge-tts, yt-dlp, hyperframes CLI) в .tools/, а скиллы hyperframes — в .agents/skills/ (OpenCode подхватывает их из этой папки). После установки перезапустите сессию агента — новые скиллы сканируются на старте сессии. В командах воркфлоу используется активатор окружения: source .tools/env.sh.

Можно поручить установку самому агенту, например:

Установи скилл https://github.com/vokasug/hyperframes-video-generation-skill в этот проект по инструкции из его README (git clone в .agents/skills/ + bootstrap.sh --install).

Глобально (для всех проектов)

Требуется Homebrew. Склонируйте репозиторий в папку скиллов вашего агента:

# OpenCode
git clone https://github.com/vokasug/hyperframes-video-generation-skill \
  ~/.config/opencode/skills/hyperframes-video-generation

# Claude Code
git clone https://github.com/vokasug/hyperframes-video-generation-skill \
  ~/.claude/skills/hyperframes-video-generation

Проверка окружения и глобальная установка недостающего:

bash ~/.config/opencode/skills/hyperframes-video-generation/scripts/bootstrap.sh --check
bash ~/.config/opencode/skills/hyperframes-video-generation/scripts/bootstrap.sh --install --global

Использование

Просто скажите агенту, например:

• «Сделай видео по этой статье» (и приложите файл)
• «Создай обучающее видео про LLM-агентов на 2 минуты»
• «Сделай подкаст-разбор книги "Идиот" двумя голосами»

Скилл сам задаст уточняющие вопросы (одним блоком, с дефолтами), покажет бриф и раскадровку, озвучит, соберёт анимацию и отрендерит MP4 — с ревизиями на каждом ключевом этапе.

Структура

SKILL.md        — точка входа: правила, воркфлоу (8 этапов, 3 ревизии)
references/     — справочники: пайплайн, сценарии, стили, сцены, TTS, музыка, контракт
scripts/        — bootstrap, TTS по сценам, таймлайн, подготовка BGM, проверка рендера
assets/         — шрифты (woff2, кириллица) + fonts.css

Лицензии

• Код и документация: MIT
• Шрифты в assets/fonts/: SIL Open Font License 1.1 (Unbounded, Manrope, JetBrains Mono — Google Fonts)