Скилл «Видео в стиле Astra DS» (README.md)

Источник: ds-internal/presentations/component-video-skill/README.md — часть скилла astra-component-video

Пакет для ИИ-агентов: по ссылкам на Figma, описанию доработки или сценарию агент собирает ролик в фирменном стиле Astra Design System — 4:3, 1440×1080, MP4 со звуком: интро → обложка → сцены → финал «разработано дизайн-командой». Три вида роликов:

короткий ролик о доработке компонента, около 30 секунд;
обучающая видео-презентация без голоса, около минуты;
объясняющий ролик с голосом диктора, 1–4 минуты: сначала раскадровка на согласование, потом озвучка локальной моделью, сведение с музыкой и проверка голоса распознаванием.

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

Что внутри


`SKILL.md`	инструкция для агента — главный файл
`AGENTS.md`	короткий вход для агентов без поддержки скиллов
`references/`	справочники: сцены, раскадровка, голос, инфостиль, выгрузка из Figma, грабли, движок
`template/`	шаблон роликов: движок, шрифты Inter и JetBrains Mono, музыка, голос, инструменты, образцы
`template/tools/build.mjs`	сборка ролика одной командой, с голосом и без
`template/tools/voice.py`	голос диктора: озвучка фраз и сведение с музыкой
`template/tools/voice_check.py`	проверка голоса распознаванием Whisper
`template/tools/selftest.mjs`	самопроверка против эталона `template/tests/`
`template/VERSION`	из какой версии шаблона собран пакет

Что нужно на машине

Node.js 22 или новее;
Python 3.10+ и pip install -r template/requirements.txt (numpy, scipy, Pillow);
ffmpeg и ffprobe в PATH;
доступ к npm: пакет hyperframes ставится через npx сам и сам скачивает Chrome для рендера;
для работы с макетами — Figma MCP (официальный сервер Figma) с правами редактора на файл;
для голоса — отдельное окружение Python с моделью Qwen3-TTS (нужна видеокарта NVIDIA, 4,4 ГБ памяти) или Silero (процессор), для проверки — faster-whisper. Установка — references/voice.md. Без него собираются ролики без голоса и ролики, чьи фразы уже озвучены.

Установка

Распаковать архив — получится папка astra-component-video/.

Агенты с поддержкой скиллов (формат SKILL.md) — положить папку туда, где агент ищет скиллы:

Claude Code: ~/.claude/skills/astra-component-video/ (для всех проектов) или <проект>/.claude/skills/astra-component-video/ (для одного);
Codex CLI: ~/.codex/skills/astra-component-video/;
другие агенты — по их документации: формат тот же, папка с SKILL.md.

Агенты без скиллов (Cursor, Gemini CLI, Copilot и т. п.): положить папку в проект и добавить в правила агента строку: «Для видео в стиле Astra DS читай astra-component-video/AGENTS.md». Или просто начать разговор с «прочитай astra-component-video/SKILL.md».

Агенту нужны доступ к оболочке (запуск node, python, npx) и запись файлов в проекте. Чат без выполнения команд ролик не соберёт.

Первый запуск

Скопировать template/ в рабочую папку проекта (агент делает это сам на шаге 0) и проверить машину:

cd astra-video
node tools/selftest.mjs

Около четырёх минут: собираются пять образцов, метки, музыка, сведение с голосом и кадры сверяются с эталоном. Конец — «Всё совпало с эталоном». С ключом --render дополнительно рендерится первый образец целиком.

Как просить

Сделай видео по доработке Toolbar AF: новое свойство Type Scale, версия 2.0.0. Вот ссылки: компонент <ссылка>, матрица Scale <ссылка>, экраны <ссылка>.

Агент разберёт ссылки, выберет сцены, выгрузит кадры, соберёт и покажет снимки, отрендерит renders/<ролик>.mp4 и перечислит, откуда взял каждый текст.

Собери объясняющий ролик с голосом о дизайн-контракте по сценарию design-contract-contractor.md.

Агент соберёт раскадровку: кадр, текст голоса, источник; цифры с источниками; вопросы до записи. После ваших комментариев он сделает пробный первый блок, чтобы вы утвердили голос, затем весь ролик. Голос он проверит распознаванием.

Обновление пакета

Пакет собирается из шаблона в репозитории astra-doc (ds-internal/presentations/component-video) командой python -I pack.py в папке ds-internal/presentations/component-video-skill. Скрипт:

копирует шаблон и образцы;
записывает эталон самопроверки;
кладёт архив в dist/astra-component-video.zip.

Правки движка делаются в исходном шаблоне, затем пакет пересобирается: копии у исполнителей сами не обновятся.