skill-video-studio README

README проекта с github.com/aaitor/skill-video-studio. Одним файлом markdown: README.md.

Video Studio Skill — from product workflow to polished demo

Video Studio Skill

From product workflow to polished demo.

v1.0.1 release · aaitor/skill-video-studio

Quick start · Worked videos · Usage · Contribute

MIT license Offline source and documentation checks

A local video-production workspace driven by the /devrel-video Claude Code skill. Capture real product interactions with Playwright CLI, compose title cards, chapters, and CTAs with HyperFrames, then master and inspect the result with FFmpeg. Start with a silent walkthrough; add narration, music, subtitles, or your own presenter footage when needed.

Demo

Preview the narrated terminal-to-browser walkthrough

Download the full MP4 — one consistent narrator across terminal → browser → terminal, with a real Acme browser capture, category filtering, project details, and a finished render. The scene timing follows the complete voice takes so sentences finish before the next scene. Source, rebuild commands, and QA.

The terminal scenes are authored reenactments of the workflow. For a separate live Claude Code intake recording, see the short setup demo; that recording stops before capture/render.

Example 2: Nevermined Catalog

Another video created with the skill: The Nevermined Catalog: describe the outcome, your agent builds it. Click the preview to watch on YouTube with sound.

Watch The Nevermined Catalog on YouTube

Quick start

For planning: Git and authenticated Claude Code. Clone the full workspace so its native skill and project layout stay together:

git clone https://github.com/aaitor/skill-video-studio.git
cd skill-video-studio
claude

Ask Claude:

/devrel-video Prepare a 25-second silent walkthrough brief for the bundled
Acme app: show the workspace, filter by category, then open a project.
Reuse brands/acme. Show the plan before capture or rendering.

Expected result: a project brief and a concrete beat plan. For a complete video, install the capture/render prerequisites and follow the worked walkthrough. The production stack needs Node.js 22+, FFmpeg/ffprobe, Chromium, and the helper-specific Python dependencies. Optional narration and avatars require your own additional services or GPU setup.

Features

Portrait/social output profiles remain on the roadmap. Full capture/render depends on your local toolchain; offline CI checks sources and selected local utilities, not the complete production stack. See workflow and usage.

Worked videos

Product walkthrough: a local Acme fixture, real browser capture, narration/music, and EN/ES subtitles. Source and commands · Watch with sound.

Acme product walkthrough

Composed CLI/browser film: a multi-environment example whose terminal scenes are authored HTML reenactments. Source and explanation · Download video with sound.

Composed terminal and browser example

The checked-in assets/default-demo.mp4 is the reviewed README video. Other generated MP4/audio files are ignored; rebuild them from the included sources. See usage prompts for silent, narrated, avatar, voice-swap, and multi-environment requests.

Configuration

Each video uses projects/<slug>/brief.yaml, brand tokens under brands/<name>/, and generated output under its project folder. Optional private settings live outside Git, selected by DEVREL_VIDEO_ENV.

Setting Purpose
brief.yaml Product URL, audience, message, beats, brand, duration, and optional layers
ORPHEUS_URL / ORPHEUS_KEY Your optional narration endpoint and token
AVATAR_HOST / LS_DIR Your optional SSH GPU host and LatentSync checkout
BGM_STYLE Local background-music style; default corporate

See configuration, the actual brief template, and security/privacy guidance. Keep private footage and credentials outside this public repository.

How it works

Brief → explore → brand → capture → compose → optional layers → render/QA → thumbnail. The skill coordinates existing tools rather than replacing them. Detailed production steps are in the workflow guide and production notes.

Repository layout

.claude/skills/devrel-video/  Skill instructions, scripts, templates, production notes
brands/                     Brand tokens and logos
projects/                   Curated public examples; private projects stay ignored
examples/                   Real harness recording, public input, generated brief
assets/                     Shared banner, social card, and short terminal GIF
docs/                       Onboarding, usage, configuration, troubleshooting

Documentation

Contributing and support

Use Issues for questions, bugs, and ideas. Read CONTRIBUTING.md and CODE_OF_CONDUCT.md; report vulnerabilities privately through SECURITY.md.

Install requirements-dev.txt in a virtual environment and run python3 scripts/check.py. See CHANGELOG.md for changes. Live recordings, service calls, GPU jobs, and full renders are manual validation steps.

License

MIT for original studio content. Embedded banner fonts retain their OFL notices; external tools/models/media retain their own terms. See licensing.


Built by Aitor Argomaniz · LinkedIn · More open source

skill-video-studio (aaitor/skill-video-studio)

Ищем в базе…

Что это такое?Локальная рабочая среда для производства видео с демонстрациями продуктов, которой управляет скилл /devrel-video для Claude Code. Она записывает реальные действия в браузере с помощью Playwright, создаёт титульные карточки и призывы к действию с помощью HyperFrames и готовит итоговый файл с помощью FFmpeg.
Это отдельное приложение или скилл для Claude Code?Это скилл для Claude Code внутри склонированного проекта, поэтому вы просите Claude сделать видео по брифу, а не запускаете отдельную программу. Он координирует уже существующие инструменты, а не заменяет их.
Можно попробовать без установки всего набора инструментов?Да, для планирования нужны только Git и Claude Code с выполненным входом. Склонируйте проект и попросите Claude составить бриф: вы получите описание проекта и конкретный пошаговый план сцен, а не готовое видео.
Что нужно для полного видео?Node.js 22+, FFmpeg с ffprobe, Chromium и Python-зависимости вспомогательных скриптов. Озвучка и аватары необязательны и требуют дополнительных сервисов или настройки с GPU.
Есть ли что-то, что пока не умеет?Профили вывода для портретного видео и соцсетей пока в планах. Полная запись и рендеринг зависят от вашего локального набора инструментов, а офлайн-CI проверяет только исходники и отдельные утилиты.
Где хранятся мои записи и учётные данные?Личные записи и учётные данные предназначены для хранения вне публичного репозитория. Необязательные личные настройки хранятся вне Git и выбираются через переменную окружения.
Записывает ли оно реальный продукт или имитирует интерфейс?Оно управляет продуктом в браузере через Playwright CLI, используя скрипты с явно прописанными сценами и стабильными селекторами, поэтому записи реальные. Только терминальные сцены в одном примере являются созданными вручную HTML-реконструкциями.
Что показывают два примера?Первый — озвученный обзор продукта на английском и испанском (EN/ES), построенный на локальной тестовой сборке Acme. Второй — фильм, охватывающий несколько сред: CLI и браузер. Сгенерированные файлы MP4 и аудио в репозиторий не входят, поэтому их нужно пересобрать из прилагаемых исходников.
Можно ли использовать свой бренд и записи ведущего?Да. Бренды — это многоразовые токены в папке brands, а записи ведущего могут быть вашими собственными медиафайлами, которые хранятся вне репозитория.
Что из этого можно проверить автоматически?Офлайн-CI проверяет исходники и отдельные локальные утилиты. Живые записи, вызовы сервисов, задачи на GPU и полный рендер — это ручные шаги проверки.
Автор
aaitor
Размер
15.2 MB
Звёзды
398
Возраст
2 мес
Коммиты · 90 дней