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

frame-capture — скилл для Claude Code: запись страниц в видео

Скилл frame-capture для Claude Code записывает веб-страницы в MP4 с покадровым управлением временем. Запускается для записи анимаций и прокрутки или сравнения двух клипов.

MIT ★ 448 обновлён 2026-11-09

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills
Открыть на GitHub

Что делает frame-capture

frame-capture записывает веб-страницы в MP4, продвигая виртуальные часы на один кадр за раз. Так анимации CSS, видео и сцены на three.js или WebGL привязаны к времени записи, а не к скорости отрисовки экрана. Скрипт scripts/record.py задаёт прокрутку, движение указателя и условие готовности страницы.

Скрипт scripts/compare.py объединяет две записи вертикально или рядом и добавляет подписи. Для раздачи страницы нужен scripts/serve.py: встроенный python3 -m http.server не обрабатывает HTTP Range-запросы, и видео на странице не сможет перематываться. Нужны Python 3.9+, пакеты playwright и pillow, установленный через Playwright браузер Chromium или WebKit и ffmpeg в PATH.

В записи через WebKit снимок на 1080p иногда зависает; скрипт повторяет попытку с тем же кадром. Для страниц с Lenis есть флаг --kill-lenis, а другие библиотеки плавной прокрутки нужно отключить в режиме ?record=1.

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

  • записать прокрутку страницы в MP4
  • снять анимацию WebGL покадрово
  • сопоставить два клипа с подписями
  • получить запись страницы без рывков реального времени

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

  • Запиши прокрутку страницы http://127.0.0.1:8000/ в MP4.
  • Сними демонстрационный ролик этой сцены на three.js.
  • Сравни a.mp4 и b.mp4 в одном видео с подписями «До» и «После».

Как установить frame-capture

1Через маркетплейс плагинов

/plugin marketplace add Moh4696/open-3d-skills
/plugin install open-3d-skills@open-3d-skills

Команда ставит плагин open-3d-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add Moh4696/open-3d-skills --skill frame-capture -a claude-code

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

~/.claude/skills/frame-capture/SKILL.md

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

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

Вопросы о frame-capture

Как установить frame-capture в Claude Code?

Выполни команды по порядку: /plugin marketplace add Moh4696/open-3d-skills, затем /plugin install open-3d-skills@open-3d-skills.

Что делает frame-capture?

Скилл записывает веб-страницы в MP4, управляя временем покадрово, а также собирает два клипа в подписанное сравнение.

Что нужно для работы frame-capture?

Нужны Python 3.9+, пакеты playwright и pillow, браузер Chromium или WebKit, установленный через Playwright, и ffmpeg в PATH.

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

SKILL.md · MIT
---
name: frame-capture
description: Records any web page (three.js, WebGL, canvas, GSAP, CSS animation, scroll-driven video) to a perfectly smooth 60 fps MP4 by running the page on a virtual clock, one exact frame at a time, and puts two recordings against each other as a labelled stacked or side-by-side comparison. Use when someone wants a video of a site, a demo clip for X or YouTube, a scroll-through, a showcase reel of a 3D scene, or a "model A vs model B" comparison video. Also use when a screen recording of an animated page stutters or drops frames.
---

# Frame capture

Screen recorders capture whatever the GPU managed to draw in real time, so a heavy scene stutters and a scroll-through looks hand-held. This skill records differently. Before the page's own scripts run, its clock is replaced: `performance.now`, `Date.now` and `requestAnimationFrame` read a virtual time, CSS animations and transitions are pinned to it, and every `<video>` is paused and seeked to it. Each output frame advances the clock by exactly 1/60 s, runs one frame, and takes a screenshot. A frame can take two seconds to render and the video still plays at a perfect 60 fps.

## Tools

| Script | What it does |
| --- | --- |
| `scripts/record.py` | Records a URL to MP4 with scroll keys, pointer motion and a ready condition |
| `scripts/compare.py` | Stacks two clips (or sets them side by side) with labels and rounded panels |
| `scripts/serve.py` | Static server that answers HTTP Range requests, so videos can seek |

Needs Python 3.9+, `pip install playwright pillow`, `python3 -m playwright install chromium webkit`, and ffmpeg on PATH.

## Run

1. **Serve the page with `scripts/serve.py`**, never `python3 -m http.server`. The built-in server ignores Range requests. The browser then cannot seek any video it serves (`video.seekable` is empty) and every recorded video holds its first frame. `record.py` warns when it sees this.

   ```bash
   python3 scripts/serve.py path/to/site --port 8000
   ```

2. **Make a fast timing pass first.** Ten frames a second shows the choreography in seconds instead of minutes:

   ```bash
   python3 scripts/record.py http://127.0.0.1:8000/ /tmp/check.mp4 --seconds 20 --fps 8 \
     --scroll "0:0 2.5:0 9:40% 12:40% 19:100%" --pointer drift
   ```

   Watch it, adjust the keys, repeat. Only then render the full clip.

3. **Render the final.** `--size` is the CSS viewport and `--dpr` multiplies it. `--size 1920x1080 --dpr 1` makes 1080p; `--size 1280x720 --dpr 1.5` makes the same 1920x1080 with a larger layout. Output is H.264, CRF 16, yuv420p, BT.709 tags, faststart, no audio.

   ```bash
   python3 scripts/record.py http://127.0.0.1:8000/ out.mp4 --seconds 20 --fps 60 \
     --scroll "0:0 2.5:0 9:40% 12:40% 19:100%" --pointer drift --ready "window.__ready === true"
   ```

4. **Look at the result** before handing it over. Pull frames at the moments that matter (`ffmpeg -ss 9 -i out.mp4 -frames:v 1 f.png`) and check them: first frame, every scroll stop, the last frame.

### Choreography

- `--scroll` keys are `seconds:position`. Positions are pixels (`1200`), a share of the scroll range (`40%`) or viewport heights (`2.5vh`). Segments ease (half linear, half smootherstep, so a long move never sprints in the middle). Add `~` after the time for a linear segment: `9~:60%`.
- Hold on anything the viewer needs to read: give a pinned section or a counter its own key pair with the same position.
- `--pointer drift` circles the real mouse slowly round the centre, so hover states, parallax and cursor-following rigs come alive. `--pointer 0.7,0.3` parks it.
- For choreography the page knows best (camera flights, a tour), let the page drive itself: define `window.__recordFrame = (t) => { ... }` behind a `?record=1` flag. It is called with the virtual time in seconds before each frame. `window.__recording` is true while recording.
- Smooth-scroll libraries fight a recorder that sets the scroll position. `--kill-lenis` stops Lenis from loading. For others, switch them off under `?record=1`.

## Make the page recordable

- **Time comes from `performance.now()` or the rAF timestamp, never from `setTimeout` or `setInterval`.** Timers keep real time while the clock is virtual, so a `setTimeout(next, 3000)` fires after three real seconds, which might be frame 20 or frame 400. Schedule on the page clock instead:

  ```js
  const pending = [];
  const later = (secs, fn) => pending.push({ at: performance.now() / 1000 + secs, fn });
  // in the frame loop:
  const now = performance.now() / 1000;
  for (let i = pending.length - 1; i >= 0; i--) if (now >= pending[i].at) pending.splice(i, 1)[0].fn();
  ```

- Expose a ready flag (`window.__ready = true` after the first rendered frame, textures decoded, fonts loaded) and pass it as `--ready`. Recording before assets land bakes a loading flash into frame 0.
- In record mode, hide UI that would not be in a film: hints, cursors, loaders, cookie bars.
- If WebGL frames come out black or stale, create the renderer with `preserveDrawingBuffer: true` when recording.

## Browsers

- **Chromium (default)** runs WebGL on the real GPU headless. On macOS the script adds `--use-angle=metal`, which renders at full speed; without it Chromium falls back to SwiftShader, which is correct but many times slower.
- **WebKit** (`--browser webkit`) shows how Safari renders: different font smoothing, colour handling and video decoding. Its screenshots occasionally stall at 1080p (about 1 in 100); the script retries, and because the clock is paused between steps the retry returns the identical frame.
- If Playwright's own Chromium is missing (a version mismatch after an upgrade), the script finds the newest Chromium in the Playwright cache. `CHROME_PATH` overrides it.
- Never record in a visible browser tab you are not looking at, and never in a hidden embedded preview pane. Background tabs throttle or freeze `requestAnimationFrame`. Headless does not.

## Comparisons

```bash
python3 scripts/compare.py a.mp4 b.mp4 versus.mp4 --labels "Model A" "Model B"            # stacked, for phones
python3 scripts/compare.py a.mp4 b.mp4 versus.mp4 --labels "Before" "After" --layout side   # side by side
```

A fair comparison holds everything equal except the thing being compared:

- Same viewport, same duration, same choreography (`--scroll` keys reused verbatim).
- Crop each source to its content first. Strip watermarks, webcam overlays and UI chrome the other clip does not have.
- Silent output. Two soundtracks fight, and audio steals attention from the picture.
- The shorter clip holds its last frame, so both finish together.
- Name each side honestly in its label. Put the one the audience knows on top.

## Delivery

- Social platforms re-encode everything. 1920x1080 or 1080x1920 at 60 fps, H.264, CRF 14 to 18 survives that best. Higher resolutions are often downscaled anyway.
- Keep the master. Make cut-downs (a 6 s loop, a vertical crop) from it with ffmpeg rather than re-recording.
- Add sound afterwards, timed to the frame numbers the recording printed. Never record audio through the virtual clock.

© exploraX · MIT · Moh4696/open-3d-skills

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

Все скиллы по теме «Фронтенд и UI» →
stitched-full-page-capture MengTo Скилл stitched-full-page-capture собирает полный скриншот страницы из кусков вьюпорта, когда обычный fullPage даёт пустоту. Пригодится на Framer, WebGL и сайтах с ленивой загрузкой. CX Codex +1 1 800установок web-shader-extractor lixiaolin94 Скилл web-shader-extractor для Claude Code и Codex извлекает и локально воспроизводит WebGL-, WebGPU-, Canvas- и шейдерные эффекты со страниц. Разбирает анимированные фоны и интерактивную 3D-графику. CX Codex +1 850установок threejs-animation CloudAI-X Скилл threejs-animation для работы с keyframe-анимацией, костями и морф-целями в Three.js. Помогает воспроизводить glTF-анимации, управлять костями скелета, миксировать и кроссфейдить клипы на WebGL и WebGPU. CX Codex +1 27 200установок 3d-web-experience sickn33 Скилл 3d-web-experience помогает создавать и отлаживать 3D-сцены, конфигураторы товаров и портфолио для веба. Разбирает выбор стека, загрузку моделей и производительность. CX Codex +1 5 400установок r3f-fundamentals EnzeD Скилл r3f-fundamentals учит агента строить сцены React Three Fiber: Canvas, типизированный JSX, хуки рендер-цикла и владение ресурсами. Для базовой архитектуры сцены, не для детальных материалов. CX Codex +1 2 400установок r3f-animation EnzeD Скилл r3f-animation для плавной анимации 3D-объектов в React Three Fiber через useFrame, damping и GLTF-клипы. Подходит для процедурного движения, переходов между состояниями и управления анимацией по запросу. CX Codex +1 2 300установок

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

site-check Скилл site-check для Claude Code проверяет 3D- и анимированные веб-страницы в браузерах Chromium и WebKit. Запускается после изменений, чтобы найти ошибки, проблемы мобильной вёрстки и просадки производительности до публикации. CX Codex +1 ★ 448звёзд репо exploded-view Скилл exploded-view для Claude Code собирает интерактивные 3D-разборки машин и продуктов в three.js. Двигает детали по этапам, показывает внутренности корпуса и подписывает части модели. CX Codex +1 ★ 448звёзд репо motion-assets Скилл motion-assets для Claude Code планирует и создаёт изображения и видеоклипы для анимированных сайтов. Он включается при запросах сгенерировать графику, зациклить фон или анимировать изображение. CX Codex +1 ★ 448звёзд репо cursor-rig Скилл cursor-rig для Claude Code собирает из иллюстрации портрет, который поворачивает голову вслед за курсором. Он включается для анимированного героя страницы без 3D-модели и отслеживания лица. CX Codex +1 ★ 448звёзд репо alpha-cutout Скилл alpha-cutout для Claude Code удаляет фон у видеоклипа и готовит прозрачную анимацию для веб-страницы. Запускается по просьбе убрать фон или добавить видео с альфа-каналом поверх контента. CX Codex +1 ★ 448звёзд репо scroll-film Скилл scroll-film для Claude Code собирает кинематографичную анимацию, привязанную к прокрутке страницы. Помогает соединить видеоклипы, настроить паузы для подписей и загрузку кадров. CX Codex +1 ★ 448звёзд репо threejs-scene Скилл threejs-scene для Claude Code создаёт интерактивные 3D-сцены на three.js из кода, без файлов моделей. Включается для 3D-сайтов, WebGL-заставок и сцен реальных объектов. CX Codex +1 ★ 448звёзд репо open-3d-skills Плагин open-3d-skills для Claude Code помогает собирать 3D-сцены и анимированные сайты. Восемь скиллов охватывают сцены на three.js, видео с прокруткой и проверку в браузерах. CX Codex ★ 448звёзд репо

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

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