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

scroll-film — скилл для Claude Code: анимация при прокрутке

Скилл scroll-film для Claude Code собирает кинематографичную анимацию, привязанную к прокрутке страницы. Помогает соединить видеоклипы, настроить паузы для подписей и загрузку кадров.

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

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

Что делает scroll-film

Скилл помогает собрать секцию, в которой прокрутка страницы переключает кадры заранее отрисованного движения камеры или объекта. Он описывает подготовку отдельных клипов, соединение их в последовательность WebP или видео и проверку стыков на заметные скачки. Для плавного перехода стыки проверяет скрипт scripts/prep.py seams.

Движок закрепляет canvas на экране и связывает положение прокрутки с кадрами; одинаковые значения кадров в ключах задают паузу для текста. Есть варианты кадров и видео, отдельный набор для телефона и режимы prefers-reduced-motion. Для подготовки нужны ffmpeg, ffprobe, Python 3.9+ и пакеты из команды pip install pillow numpy. Видео на сервере без поддержки Range-запросов не сможет перематываться.

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

  • связать прокрутку страницы с кадрами заранее созданного ролика
  • сшить клипы и найти скачок на стыке
  • удержать кадр, пока посетитель читает подпись
  • подготовить отдельную версию анимации для телефона

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

  • Собери секцию с анимацией камеры, которая меняется при прокрутке.
  • Соедини клипы в один ролик и проверь стыки между ними.
  • Добавь паузы на ключевых кадрах, чтобы подписи можно было прочитать.

Как установить scroll-film

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 scroll-film -a claude-code

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

~/.claude/skills/scroll-film/SKILL.md

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

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

Вопросы о scroll-film

Как установить scroll-film в Claude Code?

Добавь маркетплейс командой /plugin marketplace add Moh4696/open-3d-skills, затем установи скилл: /plugin install open-3d-skills@open-3d-skills.

Что делает scroll-film?

Скилл помогает создать секцию сайта, где прокрутка управляет кадрами заранее отрисованного видео. Он описывает подготовку клипов, проверку стыков, паузы для текста и варианты для телефона.

Что нужно для работы scroll-film?

Для подготовки клипов нужны ffmpeg, ffprobe, Python 3.9+ и пакеты pillow и numpy, устанавливаемые командой pip install pillow numpy.

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

SKILL.md · MIT
---
name: scroll-film
description: Builds scroll-scrubbed film sections, where scrolling plays a pre-rendered camera move, a product turning, a liquid pour or a fly-through one exact frame at a time, from AI-generated or rendered clips. Covers chaining clips into one seamless film with start and end frames, frame sequences versus scrub-ready video, pinned sections with holds for text, phone versions, loading budgets and reduced motion. Use for "scroll-driven animation", "Apple-style scroll video", "fly through the world as you scroll", scroll cinematics, or when a scrubbed video on a page stutters, jumps at a seam or loads too slowly.
---

# Scroll film

A scroll film pins a canvas while the visitor scrolls through a tall section, and the scroll position picks the frame. The visitor drives the camera, which is why it feels three-dimensional even when every frame was rendered in advance. It is the right tool when the motion is too rich for real-time 3D (generated worlds, liquids, people) and the path is fixed.

## Tools

| File | What it does |
| --- | --- |
| `assets/scroll-film.js` | The engine: pinned canvas, progress-to-frame keys with holds, frame sequences or video, smoothing, reduced motion |
| `scripts/prep.py frames` | Joins clips into one numbered WebP sequence and a manifest |
| `scripts/prep.py video` | Joins clips into one MP4 encoded for instant seeking |
| `scripts/prep.py seams` | Scores every join between clips and fails on a visible jump |

Needs ffmpeg and ffprobe, Python 3.9+ and `pip install pillow numpy`. Making the clips is `motion-assets`; transparent subjects are `alpha-cutout`; checking the result is `site-check` and `frame-capture`.

## Plan before generating anything

1. **Write the story as beats.** One beat per scene: what the camera sees at the start, where it goes, what the visitor reads there. Four to seven beats fill a landing page. A beat is one generated clip (a "leg").
2. **Make the keyframes first, all of them, in one style.** A leg is generated between a start frame and an end frame, and the end frame of one leg is the start frame of the next. Generate every keyframe still with the same model and the same style reference before any video, and lay them out side by side. A style that drifts between stills drifts across the whole film.
3. **Budget it out loud.** Cost is roughly stills plus legs times the price of one clip. A phone version in portrait doubles the video cost (see Phones). Calibrate with one still and one clip before committing (`motion-assets` covers model choice, pricing and rate limits).

## Build

1. **Generate the legs** with start and end frames from step 2. Check every join:

   ```bash
   python3 scripts/prep.py seams legs/01.mp4 legs/02.mp4 legs/03.mp4
   ```

   Under 4 is invisible; over 10 is a jump. Fix a bad seam by regenerating that leg anchored on the exact last frame of the previous one (extract it with ffmpeg rather than reusing the still: models shift colour and framing slightly).

2. **Choose frames or video.**

   | | Frame sequence (default) | Scrub video |
   | --- | --- | --- |
   | Accuracy | Exact frame for every scroll position | Seeks land a little late, worst on Safari and low-end phones |
   | Size | 20 to 60 kB a frame at 1280 to 1600 px | About a third of that |
   | Good for | Up to roughly 300 frames | Long films where size matters more than precision |

   ```bash
   python3 scripts/prep.py frames legs/*.mp4 site/film/lg --width 1600 --fps 24
   python3 scripts/prep.py frames legs/*.mp4 site/film/sm --width 900 --fps 24 --quality 72
   python3 scripts/prep.py video legs/*.mp4 site/film.mp4 --width 1920 --gop 4
   ```

   `frames` drops each later leg's first frame, which duplicates the previous leg's last. `video` uses a 4-frame GOP and no B-frames: a normal export with a 250-frame GOP makes every seek decode hundreds of frames, and scrubbing stutters.

3. **Mark up the section.** Height sets how much scrolling the film takes. Roughly one viewport of scroll per second of film feels deliberate; less feels rushed.

   ```html
   <section id="film" style="height: 600vh">
     <div class="pin" style="position: sticky; top: 0; height: 100vh">
       <canvas style="width: 100%; height: 100%; display: block"></canvas>
       <div class="captions">...</div>
     </div>
   </section>
   ```

4. **Wire the engine.**

   ```js
   import { ScrollFilm } from "./scroll-film.js";
   const small = matchMedia("(max-width: 760px)").matches;
   const film = new ScrollFilm({
     section: document.querySelector("#film"),
     canvas: document.querySelector("#film canvas"),
     frames: { count: 247, src: (i) => `film/${small ? "sm" : "lg"}/${String(i).padStart(3, "0")}.webp` },
     keys: [[0, 0], [0.18, 60], [0.3, 60], [0.62, 160], [0.72, 160], [1, 246]],
     onUpdate: ({ progress }) => captions(progress),
     onReady: () => document.body.classList.add("film-ready"),
   });
   ```

   `keys` are `[progress, frame]` pairs. Two keys with the same frame make a hold: the film waits at a beat while its caption scrolls in and out. Put a hold at every beat that carries words. Without holds, text slides over a moving picture and nobody reads it.

   `smooth` (default 0.18) eases the film toward the scroll position, frame-rate independently, so mouse-wheel steps become motion instead of jumps. If the page already smooths scrolling (Lenis), set `smooth: 1`.

   Captions and layers read `progress` in `onUpdate`. Fade a caption in over a short range at the start of its hold and out at the end; keep it off the busiest part of the frame, with a soft scrim behind if needed.

## Phones

A 16:9 film centre-cropped to a portrait phone usually loses the subject. Check the crop on every beat. If it fails, generate portrait (9:16) legs from portrait keyframes and ship them as a separate set, switched by a media query, and say up front that this doubles the video budget. A centre crop is acceptable only when every beat keeps its subject in the middle third.

Phones also get the small frame set and should stay under about 8 MB for the whole film.

## Loading

- Put frame 0 in the HTML as an `<img>` (or as the canvas background) so the first paint is the film, not a blank box.
- The engine loads frame 0, then the last frame, then a coarse-to-fine spread (every 64th, every 32nd, and so on), six at a time. A visitor who scrolls fast always lands near a decoded frame and sees it sharpen.
- Video mode fetches the whole file into a blob before playing, so seeks never wait on the network.
- Serve from a host that answers Range requests. `python3 -m http.server` does not, and videos it serves cannot seek; locally, use the `frame-capture` skill's serve.py.

## Reduced motion

With `prefers-reduced-motion: reduce`, the engine steps between the key frames (`reducedMotion: "steps"`, the default) instead of playing, so every beat still shows its picture. `"still"` shows only the last key frame.

## Check

- Record a scroll-through at low frame rate to judge pacing in seconds, with the `frame-capture` skill: `record.py URL check.mp4 --fps 8 --seconds 20 --scroll "0:0 18:100%"`.
- Scrub fast up and down: nothing blank, no flash at a seam, the pin releases cleanly at the end.
- Load on a throttled connection: first paint shows frame 0.
- Check a phone viewport and a short laptop viewport (1280x720): captions must not cover the subject.

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

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

Каталог скиллов SKILL.md →
apple-launch-film charlie947 Скилл apple-launch-film для Claude Code собирает лонч-фильм в стиле Apple для Mac кодом: меню-бар, чёлку, виджеты и градиентные обои. Создаёт ролик без записи экрана и After Effects. CX Codex +1 3 300установок brand-launch-film-production calesthio Скилл brand-launch-film-production для Claude Code помогает спланировать и подготовить фильм к запуску бренда. Он подключается к задачам от разработки концепции до проверки и подготовки версий для разных площадок. CX Codex +1 167установок scenario-kinetic-film scenario-labs Скилл scenario-kinetic-film для Claude Code создаёт рекламный ролик, трейлер или фильм бренда из брифа с кинетической типографикой. Собирает сцены в ритме музыки, добавляет изображения и звуковые эффекты. CX Codex +1 156установок cinematic-film exploraX Скилл cinematic-film для Claude Code создаёт озвученные кинематографичные фильмы из кода. Включается по запросам на документальный ролик, объясняющее видео или фильм о запуске продукта. CX Codex +1 ★ 884звёзд репо anymove-film Patch Скилл anymove-film для Claude Code создаёт двухкамерный AI-клип движения существа anymove. Проверяет split screen, цвета конечностей и синхронность ракурсов. CX Codex +1 ★ 653звёзд репо blender-car-film mromidev Скилл blender-car-film для Claude Code помогает собрать короткий автомобильный фильм в Blender: от раскадровки до звука и рендера. Включается для ночной или снежной сцены, а также отдельных задач вроде настройки снега и очереди рендера. CX Codex +1 ★ 182звёзд репо

Из того же набора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звёзд репо frame-capture Скилл frame-capture для Claude Code записывает веб-страницы в MP4 с покадровым управлением временем. Запускается для записи анимаций и прокрутки или сравнения двух клипов. 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звёзд репо

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

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