demo-recorder — скилл для Claude Code: что делает и как установить
Скилл demo-recorder записывает скриптовые видеодемо веб-приложений через headless Chromium в 3K 60fps и накладывает озвучку через Cloney.
Apache-2.0 ★ 173 обновлён 2026-10-24
npx skills add sammcj/agentic-coding --skill demo-recorder -a claude-codeЧто делает demo-recorder
Скилл управляет headless Chromium по заранее описанному сценарию на JavaScript (demos/<demo>.mjs). На выходе он собирает немое видео demo.mp4 с разрешением 3K и частотой 60 кадров в секунду, сохраняя результат в папку ~/Downloads/demo-recorder/<demo>/. Если подготовлен файл закадрового текста demos/<demo>.md, инструмент генерирует реплики с помощью Cloney и сводит их с видеорядом.
Внутри связки работают Makefile, Playwright и скрипты озвучки на Bash. При первом запуске шаг record скачивает Playwright в каталог скилла, поэтому нужен доступ в сеть. Курсор на видео формируется как наложенный слой, который двигается только по событиям мыши, так что переходы между элементами задаются вызовами h.moveTo и h.wait.
Chromium требует собственный песочницу, а Cloney использует Metal, поэтому внутри изолированного окружения агента шаги record и narrate сломаются: их нужно запускать без агентского сэндбокса. Если Cloney не установлен, озвучка и сведение пропускаются, но немой ролик всё равно скомпилируется.
Какие задачи решает
- записать пошаговое демо веб-интерфейса в 3K 60fps без ручного захвата экрана
- синхронизировать тайминги экранных сцен с закадровым текстом
- озвучить сценарий через Cloney и свести голос с видеорядом
- проверить стоп-кадры каждого шага перед финальным рендером
Примеры запросов агенту
- Запиши демо интерфейса по сценарию demos/auth-flow.mjs и сохрани кадры
- Сгенерируй озвучку из demos/auth-flow.md через Cloney и сведи итоговый ролик
- Собери немое демо-видео через make без генерации звуковой дорожки
Как установить demo-recorder
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill demo-recorder -a claude-code2Вручную: положить файлы
~/.claude/skills/demo-recorder/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/demo-recorder/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill demo-recorder -a codex2Вручную: положить файлы
.agents/skills/demo-recorder/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill demo-recorder -a cursor2Вручную: положить файлы
.cursor/skills/demo-recorder/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install sammcj/agentic-coding Skills/demo-recorder/SKILL.md2Вручную: положить файлы
.github/skills/demo-recorder/SKILL.md1Через Skills CLI (Vercel)
npx skills add sammcj/agentic-coding --skill demo-recorder -a gemini-cli2Командой платформы
gemini skills install https://github.com/sammcj/agentic-coding --path Skills/demo-recorderВручную: положить файлы
.devin/skills/demo-recorder/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о demo-recorder
Как установить demo-recorder в Claude Code?
Выполните команду npx skills add sammcj/agentic-coding --skill demo-recorder -a claude-code. Скилл появится в файле ~/.claude/skills/demo-recorder/SKILL.md.
Что делает demo-recorder?
Он прогоняет веб-приложение по скрипту в безголовом Chromium, записывает видео в 3K 60fps и при необходимости дублирует его синтезированным голосом через движок Cloney.
Почему команды записи и озвучки нельзя запускать в сэндбоксе агента?
Chromium требует собственную изоляцию процессов, а модуль Cloney задействует графический API Metal. Обе технологии падают внутри песочницы Claude Code, поэтому команды record и narrate вызывают вне сэндбокса.
Исходный текст
SKILL.md · Apache-2.0
---
name: demo-recorder
description: Use when the user wants a scripted screen-recording demo video of a web app, a narration script or text-to-speech voice-over for one, or a dubbed cut.
metadata:
version: 2026-10-12
---
Drives headless Chromium through a scripted walkthrough, encodes a silent 3K 60fps `demo.mp4`, then optionally voices the narration with Cloney and dubs it on. Below, `$M` means `make -f <this-skill-dir>/Makefile`; run it from the directory holding `demos/`; output goes to `~/Downloads/demo-recorder/<demo>/` unless `OUT=` says otherwise. `$M help` lists the targets; each script in `scripts/` takes `--help`.
## Workflow
1. Create a task per step below, phrased with its completion criterion, then work them to completion.
2. Write `demos/<demo>.mjs` exporting `options`, `setup()`, `run(h, ctx)` and `teardown(ctx)`, modelled on `assets/examples/openspeccer.mjs`; the `h` helpers are in `scripts/lib/recorder.mjs`.
3. In `setup()`, record against a throwaway copy of the target so on-camera edits leave the user's repo untouched.
4. Call `h.scene("<name>")` at the start of each narrated section.
5. Write `demos/<demo>.md`: one `## N. Title` section per scene in recording order, an `_On screen: ..._` note, then the spoken text at about 2.2 words per second of scene (example: `assets/examples/openspeccer.md`).
6. Run `$M record encode DEMO=demos/<demo>.mjs`. Done when `~/Downloads/demo-recorder/<demo>/timings.tsv` lists every scene and you have viewed every image in `~/Downloads/demo-recorder/<demo>/stills/`.
7. Fix what the stills show (missed click, wrong tab, personal paths via `options.hide`), then repeat step 6.
8. Ask which Cloney character and engine to use (offer `$M voices`; defaults are in `scripts/narrate.sh --help`), unless the user records clips themselves as `N.wav` in `~/Downloads/demo-recorder/<demo>/audio/`. If a `cloney` skill is available, activate it first; otherwise `cloney --help` covers the CLI.
9. Run `$M narrate DEMO=demos/<demo>.mjs VOICE=<character> ENGINE=<engine>`. Done when no row says FAILED or "runs past scene". Re-run for a take that said the wrong words (a fresh seed usually fixes it); trim the text of a clip that runs past its scene.
10. Run `$M dub DEMO=demos/<demo>.mjs`. Done when its table has no `(no clip)` row; then report `~/Downloads/demo-recorder/<demo>/demo-dubbed.mp4`.
## Gotchas
- Chromium needs its own sandbox and Cloney needs Metal; both fail inside the agent sandbox, so run `record` and `narrate` unsandboxed.
- `record` installs Playwright into the skill directory on first run; that needs network access.
- Check clips with `ffprobe` and `ffmpeg -af volumedetect`; never play audio, leave listening to the user.
- Breeze takes 35-75 s per clip. `narrate.sh` caches renders and re-renders only sections whose text or voice changed, so edit and re-run freely. Delete `~/Downloads/demo-recorder/<demo>/audio/.narrate/N.*` to re-render one clip; `FORCE=1` re-renders all.
- Pass `VOICE`/`ENGINE` on every `narrate` for a non-default voice; omitting them re-renders every clip in the default voice.
- `narrate` transcribes every take and rejects one that says the wrong words; `TAKES=3` keeps the shortest that passes. `VERIFY=0` skips the check.
- Without Cloney, `narrate` and `dub` skip with a message; `$M demo` still produces the silent cut.
- `dub.sh` pairs clip `N.wav` with the Nth scene in `timings.tsv`; keep section numbers in scene order.
- The cursor is an injected overlay that only moves on mouse events; `h.moveTo` onto whatever the narration names, and `h.wait` before the next `h.scene` so the narration has room.
- Keep spaces out of the `DEMO` path; make splits it and mangles the output folder name.
- `~/Downloads/demo-recorder/<demo>/frames/` runs to about 800 MB per 90 s; offer to delete it once the cut is final.
© sammcj · Apache-2.0 · sammcj/agentic-coding