claude-video-kit — скилл
Скилл video-explainer собирает вертикальный ролик 9:16 из сценария: озвучка, субтитры, Remotion и проверка перед рендером
- 122 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Скрипты конвейера запускаются локально, ставят npm- и Python-зависимости и вызывают ffmpeg
- Текст сценария уходит в Fish Audio, для чего в `.env` хранится секретный ключ API
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add skills/claude-video-kitОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Скрипты конвейера запускаются локально, ставят npm- и Python-зависимости и вызывают ffmpeg
- Текст сценария уходит в Fish Audio, для чего в `.env` хранится секретный ключ API
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Скилл `video-explainer` ведет агента от исследовательской заметки, готового сценария или готового MP4 к проверенному вертикальному ролику. Он сначала выбирает самую простую стратегию производства, а если она не проходит проверки, возвращается к детерминированному рецепту репозитория на Remotion. Сам скилл ничего не загружает и не публикует. Конвейер по `script.json`: озвучка, выравнивание субтитров по словам через faster-whisper, сборка метаданных и рендер в 1080×1920. Типы слайдов: `cover`, `text`, `code` и `numberHero`. Длительность слайда считается по длине аудио. Озвучку делает Fish Audio или локальный IndexTTS2 с GPU, для проверки конвейера подойдет `say` из macOS. Перед рендером нужна независимая проверка: квитанция привязана к точному содержимому `script.json`, и без нее рендер не стартует. Итоговый ролик проходит релизный гейт: проверку шортсов (формат, длительность до 60 секунд, ритм сцен, хук) и оценку финального файла с привязкой по хэшу.
Для кого. Авторам технических и исследовательских разборов в Claude Code, Cursor или Codex, которым нужен повторяемый вертикальный ролик без монтажной программы.
Подходит, если
- Текстовый разбор надо превратить в ролик для Shorts, TikTok или Reels с озвучкой и субтитрами
- Серия роликов должна выходить в одном оформлении, а сценарии хочется хранить как JSON в репозитории
- Ролик проверяет второй человек или агент, и результат проверки нужно привязать к конкретной версии сценария
- Нужно быстро проверить на демо, что весь конвейер работает на вашем Mac без ключей API
Не подходит, если
- Нужны фабрики роликов «тема в ИИ-ролик»: автор прямо исключает генеративную лотерею и делает ставку на проверяемые сценарии
- Требуется автоматическая публикация: скилл ничего не загружает и выдает только пакет для передачи после проверки
- Ролик горизонтальный или длинный: основной конвейер рассчитан на формат 9:16, длинный формат описан отдельным экспериментальным документом
Пример запроса к агенту
Используй video-explainer: возьми scripts/my-first/script.json, прогони проверку перед рендером и собери вертикальный ролик 1080×1920Ограничения
Релиз `v0.3.0-rc.1` — публичный кандидат, стабильной версии пока нет. Проверка конвейера проводилась на macOS с Apple Silicon. Нужны Node 20 и новее, Python 3.10 и новее, ffmpeg, для озвучки по умолчанию ключ Fish Audio. Озвучка через `say` грубая: она путает китайские омографы, а выравнивание Whisper на модели `base` бывает неточным, поэтому для публикации берите Fish Audio. Скилл управляет локальным клоном репозитория и Remotion внутрь не включает. Проверки перед рендером ведет рецензент, инструмент следит за процессом и истинность содержания не оценивает.
Как отключить. Для плагина выполните `/plugin uninstall video-explainer-kit` в Claude Code. Скилл, поставленный через Skills CLI, удалите из `.claude/skills/video-explainer`, локальный клон репозитория удаляется как обычная папка.
Частые вопросы
Как поставить video-explainer в Claude Code?
Выполните `/plugin install video-explainer-kit --marketplace runesleo/x-reader` в Claude Code 2.1.275 или новее. Для Codex команды такие: `codex plugin marketplace add runesleo/x-reader`, затем `codex plugin add video-explainer-kit@runesleo`.
Нужны ли ключи API для первого запуска?
Нет, демо работает без ключей: оно использует `say` из macOS как озвучку демонстрационного качества, рендерит 1080×1920 и запускает проверку шортсов без загрузки. Для реальных роликов настройте `FISH_AUDIO_API_KEY` и `FISH_AUDIO_VOICE_ID` в `.env`.
Что блокирует рендер?
Рендер не стартует, если квитанции проверки нет, она устарела или имеет статус `fix` либо `block`. Квитанция привязана к точному `script.json`, поэтому любая правка сценария требует новой проверки.
Какие слайды поддерживает сценарий?
Четыре типа: `cover` для обложки и финала, `text` для текста с озвучкой, `code` для блоков кода и `numberHero` для крупной цифры в начале шортса. Текст озвучки задается отдельно полем `voice_text`, чтобы он мог звучать естественнее экранного.
Что проверяет verify-shorts?
Четыре условия: размер холста 1080×1920, длительность до 60 секунд, ритм сцен и появление хука. Команда `node scripts/verify-shorts.mjs <out.mp4>` запускается после рендера.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
СкиллыСкилл собирает из темы озвученное видео в 4K: исследование, сценарий, локальный TTS, монтаж на Remotion и сведение в FFmpeg
Скилл для Claude Code и Codex, который превращает тему в озвученный анимационный ролик-объяснение на Remotion с субтитрами и главами
Скилл для Claude Code и Codex: делает кинематографичные продуктовые видео на Remotion из карточек-рецептов кадров, готового шаблона и аудиоресурсов
Скилл превращает кодового агента в студию объясняющих видео с озвучкой: синхронизация по словам, каталог движений и сборка через Remotion
Скиллы для видеоканалов без лица: из одной темы выходит ролик с озвучкой, субтитрами, обложками и текстами для площадок.
Скилл-режиссер: расспрашивает про идею ролика и превращает ее в раскадровку по секундам для рендера в HyperFrames
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Звезды репозитория | Главное отличие |
|---|---|---|---|
| claude-video-kit (эта карточка) | нет | 122 | |
| Скиллы Remotion | нет | 6 431 | учит агента писать композиции Remotion без проверки сценария и озвучки |
| Video Podcast Maker | нет | 1 715 | делает видеоподкасты из текста по другому рецепту |
Коротко о README
README на английском с зеркалами на китайском открывается кратким описанием целевой аудитории и статусом релиза. Дальше идут установка плагином и через Skills CLI, быстрый успех на демо, релизный гейт, схема конвейера, список слайдов и известные ограничения первой версии.
Бейдж для README
Исходный SKILL.md
--- name: video-explainer description: Turn a research brief, finished script, or generated MP4 into a reviewed and verified vertical explainer video. Use when an agent should choose the simplest current production strategy, preserve strict final-artifact quality gates, run the deterministic Remotion fallback, diagnose the local toolchain, or verify an existing MP4 before any manual publication step. --- # Video Explainer Version note: v0.3.0-rc.1 / 2026-09-27 / Make production strategy adaptive while keeping the deterministic Remotion recipe as a strict fallback. Final-artifact acceptance is strategy-independent and bound to the exact MP4 bytes. Keep upload, account access, credentials, private voice assets, hosted rendering, and publication out of scope. Produce a local video and evidence packet. Never upload or publish from this skill. ## Core contract This Skill separates **what must be true of the final artifact** from **how the artifact is produced**. Before forcing an existing recipe, run a capability challenge: 1. Can the current model or available capability produce the final MP4 directly at the required quality? 2. Which requirements are real product, safety, brand, or evidence invariants? 3. Which existing steps only compensate for older model limitations? 4. Can intermediate stages be skipped without weakening final acceptance? 5. What is the simplest strategy likely to pass the final gates? 6. If that strategy fails, fall back to the deterministic repository-owned recipe. Choose one execution strategy: - `direct_artifact` — a current model/capability produces the final MP4 directly. Do not require `motion-storyboard.json`, `script.json`, TTS, alignment, or Remotion merely to satisfy a historical recipe. - `agent_orchestrated` — an agent may choose and combine tools as implementation details. Intermediate artifacts are optional unless they are needed to satisfy the brief or evidence requirements. - `legacy_remotion` — use the repository-owned deterministic path when direct generation cannot preserve facts, branding, layout control, narration identity, or other required qualities. All three strategies converge on objective MP4 verification plus an independent final-artifact review. Production freedom never bypasses final acceptance. ## Install The deterministic fallback orchestrates a local clone of `claude-video-kit`; it does not bundle the renderer. From the repository root, install the runtime and register the Skill with: ```bash npm ci --prefix remotion npx skills add runesleo/claude-video-kit --skill video-explainer ``` For repository development, run commands from the repository root. ## Workflow