К основному содержанию
скилл CX Codex

demo-video · microsoft — скилл для Claude Code: сборка MP4 из кадров и озвучки

Скилл demo-video собирает демо-видео из упорядоченных кадров или клипов, WAV-озвучки и переходов через FFmpeg. Для первых прототипных роликов и туториалов.

MIT ★ 1 627 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add microsoft/hve-core --skill demo-video -a claude-code
Открыть на GitHub

Что делает demo-video

Скилл берёт манифест segments.yml с описанием каждого сегмента — кадр (frame) или клип (clip), путь к изображению или видео, путь к WAV-файлу озвучки — и рендерит итоговый MP4. По умолчанию склейка жёсткая, без переходов; если в манифесте указан блок transition с type: crossfade и duration, скилл добавляет перекрёстные затухания видео и аудио на границах сегментов. Разрешение задаётся в resolution (по умолчанию 1280x720), частота кадров — в fps (по умолчанию 24). Длительность сегмента берётся из длины озвучки или переопределяется полем duration.

Для запуска используй обёртку scripts/assemble-video.sh или scripts/Invoke-AssembleVideo.ps1 с аргументами --manifest и --output. FFmpeg и ffprobe должны быть в PATH, иначе сборка не запустится. Временные файлы удаляются после рендера; итоговый MP4 записывается атомарно — если FFmpeg упал, старый файл остаётся нетронутым.

Для качественной озвучки скилл рекомендует нейросетевые голоса Azure AI Speech через скилл tts-voiceover (например, en-US-Andrew:DragonHDLatestNeural). Синтетическая озвучка требует пометки для зрителя.

Какие задачи решает

  • собрать демо-ролик из кадров прототипа и озвучки по манифесту
  • склеить несколько клипов с отдельной озвучкой для каждого
  • добавить crossfade-переходы между сценами и озвучкой
  • нормализовать разрешение и fps перед финальным рендером
  • атомарно записать MP4, чтобы при падении FFmpeg старый файл остался целым

Примеры запросов агенту

  • Собери видео из манифеста examples/segments.yml в output/demo.mp4, разрешение 1920x1080, fps 30
  • Запусти scripts/assemble-video.sh --manifest walkthrough.yml --output result.mp4
  • Добавь в манифест переходы crossfade длительностью 0.8 секунды и пересобери видео

Как установить demo-video

1Через Skills CLI (Vercel)

npx skills add microsoft/hve-core --skill demo-video -a claude-code

2Вручную: положить файлы

~/.claude/skills/demo-video/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/demo-video/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о demo-video

Как установить demo-video в Claude Code?

Выполни npx skills add microsoft/hve-core --skill demo-video -a claude-code, затем открой ~/.claude/skills/demo-video/SKILL.md.

Что делает demo-video?

Собирает MP4 из упорядоченных кадров или клипов, WAV-озвучки и опциональных crossfade-переходов через FFmpeg. Манифест описывает сегменты, разрешение и fps; скилл нормализует каждый сегмент и склеивает итоговый ролик.

Что нужно для работы demo-video?

FFmpeg и ffprobe должны быть в PATH. Без них скилл не запустится. Для озвучки используй WAV-файлы; скилл рекомендует генерировать их через tts-voiceover с нейросетевыми голосами Azure AI Speech.

Исходный текст

SKILL.md · MIT
---
name: demo-video
description: 'Assemble ordered frames or clips with narration and optional synchronized scene transitions into an MP4 via FFmpeg'
license: MIT
compatibility: 'Requires FFmpeg on PATH'
metadata:
  authors: "microsoft/hve-core"
  spec_version: "1.0"
  last_updated: "2026-10-03"
---

# Demo Video Assembly Skill

This skill assembles a narrated demo video from ordered visual segments and matching narration audio. It is designed for first-pass walkthrough videos that combine captured prototype frames or clips with per-segment voiceover WAV files.

## Overview

The workflow takes a manifest that describes each segment, resolves the visual
source, and uses FFmpeg to render each segment into a normalized video clip
before assembling the final MP4. It supports hard cuts by default or optional
synchronized video and audio fades. The narration track is muxed from WAV files
so the output can be reviewed without a separate video-editing tool.

## Manifest Schema

Use a `segments.yml` manifest with optional top-level output settings and an ordered list of segments. Each entry describes a visual source and the narration audio to combine for that portion of the video. All paths resolve relative to the manifest file.

```yaml
output: ./output/demo.mp4   # optional; destination path for the assembled MP4
resolution: 1280x720        # optional; default 1280x720
fps: 24                     # optional; default 24
transition:                 # optional; omit for hard cuts
  type: crossfade
  duration: 0.5
  fade_in: true
  fade_out: true
segments:
  - type: frame
    visual: ./frames/intro.png
    narration: ./audio/intro.wav
    duration: 4.5
  - type: clip
    clip: ./clips/interaction.mp4
    narration: ./audio/interaction.wav
```

### Top-level fields

* `output` sets the destination path for the assembled MP4, resolved relative to the manifest; the `--output` or `-OutputPath` argument overrides it when supplied
* `resolution` controls the output width and height in `WIDTHxHEIGHT` form (default `1280x720`); the `--resolution` or `-Resolution` argument overrides it
* `fps` sets the frame rate applied when rendering each segment (default `24`); the `--fps` or `-Fps` argument overrides it
* `transition` enables synchronized scene and narration fades; omit it or set it
  to `none` to retain hard cuts

### Transition fields

* `type` accepts `crossfade` or `fade`, which both select FFmpeg's fade
  cross-transition
* `duration` sets every opening, scene, audio, and closing fade in seconds
  (default `0.5`)
* `fade_in` controls the opening video and audio fade (default `true`)
* `fade_out` controls the closing video and audio fade (default `true`)

The assembler adds silent handles around speech and holds the matching endpoint
pictures. Crossfades overlap those handles, not adjacent spoken instructions;
do not pre-pad narration to compensate. The normalized segments must exceed
twice the transition duration. Output duration is the sum of unpadded narration
durations plus one transition duration per scene boundary and per enabled
opening/closing fade. With transitions disabled, no handles are added.

### Segment fields

* `type` identifies whether the segment is a still image (`frame`) or a motion clip (`clip`)
* `visual` points to an image file for a frame segment
* `clip` points to a motion clip file for a clip segment
* `narration` points to the WAV file generated from narration text (the script also accepts `narration_wav` as an alias)
* `duration` is optional and overrides the inferred duration when you want a fixed segment length

## Quick Start

Use the bash or PowerShell wrappers to invoke the assembler from the skill directory.

```bash
scripts/assemble-video.sh --manifest examples/segments.yml --output ./output/demo.mp4
```

```powershell
scripts/Invoke-AssembleVideo.ps1 -ManifestPath examples/segments.yml -OutputPath ./output/demo.mp4
```

## Parameters Reference

The assembly step accepts the following high-level controls:

* `--manifest` or `-ManifestPath` selects the YAML manifest to process
* `--output` or `-OutputPath` sets the destination MP4 path
* `--fps` or `-Fps` controls the output frame rate for rendered segments
* `--resolution` or `-Resolution` controls the output width and height in the form `WIDTHxHEIGHT`
* `--timeout` or `-TimeoutSeconds` sets the maximum seconds for each ffprobe or ffmpeg invocation (1-86400, default 600); a timed-out step stops the run with an error that names the step
* `duration` per segment lets you override the inferred length when narration timing is known in advance

## Failure Behavior

The assembled MP4 is written to a temporary file next to the destination and
moved into place only after FFmpeg succeeds. A failed, timed-out, interrupted,
or invalid transition run leaves no partial MP4 at the output path and keeps any
existing file there unchanged. A successful run replaces an existing file at
the output path. Temporary segment files are always removed.

## Narration Quality

Narration quality is the single biggest driver of how polished the final video feels. Generate narration with neural voices from **Azure AI Speech (part of Azure AI Foundry)** through the `tts-voiceover` skill, for example `en-US-Andrew:DragonHDLatestNeural` or `en-US-Jenny:DragonHDLatestNeural`. These produce natural, presentation-grade narration.

This skill assembles video locally with FFmpeg and does not generate video with an AI model. When the narration is synthetic, tell viewers that the voice is AI-generated. HVE demo-material CI publishes silent videos; internal silent timing tracks are removed during finalization.

See the `tts-voiceover` skill for the neural voice catalog, `--voice` and `--rate` controls, and Azure authentication (Microsoft Entra ID recommended, or a key).

## Reuse Bridge

This skill is intentionally designed to fit into the existing media workflow:

* `tts-voiceover` provides the narration WAV files that this skill muxes into the final output; prefer its Azure AI Speech neural voices for production-quality narration
* `vscode-playwright` provides the frame-capture source for prototype walkthroughs and screen-based demos

## Prerequisites

FFmpeg and ffprobe must be available on your PATH.

### Linux

```bash
sudo apt update && sudo apt install ffmpeg
```

### macOS

```bash
brew install ffmpeg
```

### Windows

```powershell
winget install FFmpeg.FFmpeg
```

© microsoft · MIT · microsoft/hve-core

Похожие скиллы

Все скиллы по теме «Автоматизация и no-code: n8n, Zapier, Make» →

Сначала — demo-video от других авторов.

demo-video Alireza Rezvani Скилл demo-video превращает описания сцен и скриншоты в готовые демо-ролики или GIF с озвучкой и анимацией прямо в Claude Code. CX Codex +1 708установок vox-video-director modelstudioai Скилл vox-video-director для Claude Code превращает одну тему в готовое видео в стиле Vox: коллаж-анимацию с озвучкой, музыкой и субтитрами. CX Codex +1 161установок video-edit calesthio Скилл video-edit для Claude Code обрабатывает локальные видеофайлы через ffmpeg: нарезает ролики, меняет пропорции под соцсети и сжимает дорожки. CX Codex +1 1 600установок review-video ShuaiMXu Скилл review-video для Claude Code проверяет и чинит продуктовые или промо-видео по исходному проекту, таймкодам изменений и независимой ревизии таймлайна. Запускается при видеопроизводстве или разборе багов монтажа. CX Codex +1 ★ 529звёзд репо video-pipeline notivn Скилл video-pipeline для Claude Code описывает путь от запроса до MP4 и распределяет работу между HyperFrames и Remotion. Запускается при создании видео или настройке очереди рендеринга. CX Codex +1 ★ 147звёзд репо hyperframes-sales-demo-builder OneWave-AI Скилл hyperframes-sales-demo-builder для Claude Code, Codex, Cursor и других платформ — строит персонализированное демо-видео в HyperFrames под конкретного клиента. CX Codex +1 157установок ui-demo affaan-m Скилл ui-demo для Claude Code записывает демо-ролики веб-приложения через Playwright с видимым курсором, ровным темпом и раскадровкой по шагам. Ролики — для онбординга и презентаций. CX Codex +1 6 600установок

Из того же набора148

Весь набор →
data-catalog Скилл data-catalog помогает составить Markdown-каталог данных с сущностями и их связями. Он пригодится при инвентаризации данных и подготовке каталога к построению ERD. CX Codex +1 ★ 1 627звёзд репо Supply Chain Skill Assessor Субагент Supply Chain Skill Assessor оценивает supply-chain проекта по скиллу supply-chain-security и отдаёт таблицу находок: что закрыто, что частично, где дыра. Пригодится перед релизом или разбором CI. CX Codex +1 ★ 1 627звёзд репо privacy-standards Скилл privacy-standards для Claude Code содержит справочные материалы по конфиденциальности. Используется для анализа потоков данных, оценки порогов DPIA и сопоставления требований. CX Codex +1 ★ 1 627звёзд репо copilot-tracking Правило задаёт, как хранить промежуточные материалы RPI, HVE Builder и других рабочих процессов в .copilot-tracking/. Оно помогает агенту вести исследование, планы и ревью в согласованных файлах. CX Codex +1 ★ 1 627звёзд репо dt-methods Скилл dt-methods для Claude Code содержит базу знаний по девяти методам Design Thinking и девяти отраслевым контекстам для агента dt-coach. CX Codex +1 ★ 1 627звёзд репо rpi-challenger Скилл rpi-challenger задаёт адаптивные вопросы к задаче, плану или артефакту, чтобы выявить допущения до начала работы. Сначала он просит подтвердить границы проверки. CX Codex +1 ★ 1 627звёзд репо python-foundational Скилл python-foundational для Claude Code автоматически проверяет при код-ревью диффы с .py файлами по чеклисту базовых практик Python. CX Codex +1 ★ 1 627звёзд репо ml-experimentation Скилл ml-experimentation для Claude Code описывает инженерные практики Microsoft CSE и помогает выстроить воспроизводимый трекинг ML-экспериментов. CX Codex +1 ★ 1 627звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой