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

kinetograph-migrate — скилл для Claude Code

Скилл kinetograph-migrate для Claude Code переносит проекты с Remotion на Kinetograph для рендера видео без браузера. Включается при наличии импортов remotion или скриптов remotion render.

Apache-2.0 ★ 542 обновлён 2026-11-17

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

Что делает kinetograph-migrate

Скилл проводит аудит кодовой базы на Remotion и адаптирует её под Kinetograph. Движок рендерит видео напрямую, без Chrome, Puppeteer или Playwright. Базовый пакет remotion и 24 модуля @remotion/* поддерживаются CLI автоматически, поэтому переписывать импорты компонентов не требуется.

Миграция идёт пошагово: поиск точки входа с registerRoot, диагностика командой kinetograph doctor, проверка типов и раскадровка через kinetograph strip. Пакеты @remotion/player, @remotion/renderer, @remotion/lambda и three намеренно не поддерживаются и требуют замены. Сетевых запросов во время сборки нет: fetch читает только локальные файлы проекта, а внешние ассеты нужно заранее сложить в public/.

Рендеринг строго привязан к номеру кадра. Системные шрифты вроде Helvetica вызывают пропадание текста без предупреждений от валидатора, поэтому их необходимо регистрировать через @remotion/google-fonts или локальные файлы. Финальный прогон с флагом --strict падает при первой же неподдерживаемой функции.

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

  • перенести рендеринг Remotion-проекта на Kinetograph без запуска браузера
  • найти неподдерживаемые CSS-свойства и пакеты через kinetograph doctor
  • заменить недетерминированные вызовы таймеров и Date.now() на номер кадра
  • сгенерировать превью раскадровки через kinetograph strip перед сборкой видео

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

  • Перенеси этот Remotion-проект на Kinetograph и проверь неподдерживаемые свойства
  • Запусти kinetograph doctor для точки входа src/index.ts
  • Покажи раскадровку композиции Main через команду kinetograph strip

Как установить kinetograph-migrate

1Через Skills CLI (Vercel)

npx skills add 0xS4N4TG/kinetograph --skill kinetograph-migrate -a claude-code

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

~/.claude/skills/kinetograph-migrate/SKILL.md

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

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

Вопросы о kinetograph-migrate

Как установить kinetograph-migrate в Claude Code?

Выполните команду npx skills add 0xS4N4TG/kinetograph --skill kinetograph-migrate -a claude-code. Файл навыка сохранится по пути ~/.claude/skills/kinetograph-migrate/SKILL.md.

Что делает kinetograph-migrate?

Навык автоматизирует портирование видеокомпонентов Remotion на бессерверный движок Kinetograph, устраняя зависимости от браузера и проверяя код утилитами doctor, lint и check.

Что нужно для работы kinetograph-migrate?

Требуется пакет kinetograph в dev-зависимостях проекта, локальные ассеты в папке public/ вместо сетевых ссылок и явно зарегистрированные шрифты через файлы или @remotion/google-fonts.

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

SKILL.md · Apache-2.0
---
name: kinetograph-migrate
description: Move an existing Remotion project onto Kinetograph so it renders without a browser. Use when the user has a Remotion project (remotion or @remotion/* imports, `remotion render` scripts, @remotion/three, @remotion/player) and wants it to run, preview or render with Kinetograph, or asks what in a Remotion project will not work there.
metadata:
  version: "0.4.0-rc.1"
---

# Migrate a Remotion project to Kinetograph

Most of a Remotion project runs unchanged. `remotion` and 24 `@remotion/*` packages are mapped onto Kinetograph's core
by the CLI, so the video code does not change. What changes is the tooling around it, and a few packages that have no
equivalent. There is no browser anywhere in the render path. Never add one: no Chrome, Puppeteer, Playwright or iframe
as a stopgap, for any reason.

Run commands as `npx kinetograph <command>`. Add `--json` to get one JSON object. For the other commands and the
project API, use the `kinetograph` skill.

Keep the project's own folder layout; do not move files. Only what the commands generate goes under `out/`, which is their default.

## The loop

1. **Find the entry and the compositions.** Read `package.json` (scripts, dependencies) and any `remotion.config.ts`
   too: `doctor` only sees files the entry imports, so a player page, a render script or a config file never shows up in
   its report. Search the project for `@remotion/(player|renderer|bundler|lambda|cloudrun|cli|three)`, `from 'three'` and
   `IFrame`, and treat each hit as a finding. The entry is the file that calls `registerRoot` (often `src/index.ts`;
   `package.json` scripts or `remotion.config.ts` name it). Run `kinetograph compositions <entry>`. If it fails with
   `... is not supported by Kinetograph yet`, that import is the first finding. (The message says to run `doctor`, but
   `doctor` stops on the same import until you fix it.)
2. **Doctor.** `kinetograph doctor <entry>` (add `--comp <id>` for one composition). It reports every element,
   property and reason the engine cannot draw, with frame ranges. An import that cannot be bundled stops the command
   before any report, with the package named; fix that first and run `doctor` again. Keep the report; work from it.
3. **Fix each finding.** Pick by kind:
   - `@remotion/three` or `three` imports: read `references/three.md`.
   - `@remotion/player`, `@remotion/renderer`, `@remotion/bundler`, `@remotion/lambda`, `@remotion/cloudrun`, `@remotion/cli`,
     `remotion.config.ts`, `npm run` scripts, webpack overrides: read `references/tooling.md`.
   - `IFrame`, `@remotion/webcodecs`, `@remotion/media-parser` sample callbacks, `@remotion/rive`, `@remotion/skia`,
     Canvas, WebGL or CSS issues in the report: read `references/unsupported.md`.
   - Anything else: the property or element is named in the report. Change it to one the engine draws, or leave it
     out. Do not guess; run `doctor` again.
4. **Lint.** `kinetograph lint <entry>` and `kinetograph check <entry>` (type errors). Fix every error. Errors that say
   "no declaration file" for `react` mean `@types/react` is not installed: add it as a dev dependency at the project's
   React version and tell the user. That is not a migration problem and does not block `render`.
5. **Look.** `kinetograph strip <entry> -n 12` (it writes `out/sheets/<id>-strip.png` under the project folder), then open the PNG. Use `still <entry> <frame>` for one
   frame. Compare with what the project was meant to show (a Remotion render, a screenshot, the user's description; if
   you have none, check against the code and say that you could not compare). `doctor` and `lint` can both be clean
   while text is missing, so check that every title and caption is on screen (see Fonts).
6. **Render.** `kinetograph render <entry> --comp <id> --strict` (it writes `out/renders/<id>.mp4`) (`--range 0..30` first for a quick
   test; `a..b` stops at b-1, `a..=b` includes b). `--strict` fails on the first frame
   with anything unsupported, so no video leaves with something missing.

If `--strict` still fails after the fixes, a left-over is real. Either approximate it (say how) or remove it, then say
so in step 7. Do not hide it by dropping `--strict` for the final render.

7. **Report to the user.** List what was ported as is, what was replaced (and with what), what was left out or
   approximated, and the commands to run the project now. Say plainly when the result differs from Remotion's.

## Rules

- A `remotion` import needs no edit. Do not rewrite `remotion` or `@remotion/*` imports to `@kinetographdev/core`.
- Never remove a feature silently. Every omission or approximation goes in the report from step 7.
- **Fonts.** Text in a font that is not registered may be drawn as nothing, with no warning from `doctor`. A
  `fontFamily` that names only system fonts (`Helvetica, Arial, sans-serif`) is the usual cause. Register a font file
  the user is allowed to use: `@remotion/google-fonts/<Family>` (`loadFont()`), `registerFont({ family, path:
  staticFile('F.ttf') })` from `@kinetographdev/core`, or `@font-face { src: url(...) }` in an imported `.css` file. Do not
  copy system fonts into the project.
- Rendering is a pure function of the frame. Replace `Date.now()`, `Math.random()` and timers with frame maths and
  `random(seed)`.
- There is no network. `fetch` reads project files only. Copy remote assets into `public/` and use `staticFile`.
- Do not add dependencies for the render path, except `kinetograph` itself as a dev dependency (it brings
  `@kinetographdev/core`, which the 3D elements import from). If it is not on npm yet, ask the user where to install it
  from. Packages for the studio or tests are fine.

## Coverage in one line

Core `remotion` and these `@remotion/*` packages are mapped: transitions, motion-blur, noise, paths, shapes,
layout-utils, animation-utils, captions, google-fonts, fonts, lottie, gif, media-utils, media, light-leaks, starburst,
sfx, zod-types, timeline-utils, media-parser, webcodecs, canvas, rive, skia. Not ported on purpose: three, player,
renderer, bundler, cli, lambda, cloudrun, tailwind, tailwind-v4 (Tailwind itself works). The full table is on the docs
site at `/docs/guides/migrate/`. GSAP (core, the free plugins, Flip) works too: seek a paused timeline to
`frame / fps` in a layout effect, or let a `gsap.to` in a `useEffect` play by itself (`/docs/compat/#gsap`).

Needs no rewrite: `<Img src>` of an `.svg` file (text inside it is left out), named and functional CSS colours
(`white`, `rgb()`, `oklch()`), `<TransitionSeries>` and `<Series>` children in a Fragment, `<canvas>` and `<Canvas>`,
`-webkit-text-stroke`, and symbols or emoji missing from a font (bundled fallback; CJK needs a font you load). Libraries
(Recharts, d3, rough.js, Chart.js, anime.js, Motion, Paper.js) run as they are when they draw from the frame; see
`/docs/plugins/library-adapters/`. Mermaid draws with its default HTML labels (`<foreignObject>`); load the label font first.

© 0xS4N4TG · Apache-2.0 · 0xS4N4TG/kinetograph

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

Все скиллы по теме «Фронтенд и UI» →
c-video-edit daxaur Скилл c-video-edit для Claude Code создаёт и собирает видео из кода с помощью Remotion и Editly: анимированные ролики, заставки и слайд-шоу. CX Codex +1 ★ 179звёзд репо remotion-performance-optimizer ncklrs Скилл remotion-performance-optimizer находит узкие места в Remotion-композициях: лишние перерисовки, тяжёлые расчёты, неоптимальные ассеты. Выдаёт отчёт с конкретными правками и оценкой ускорения. CX Codex +1 171установок remotion-best-practices remotion-dev Скилл remotion-best-practices для Claude Code направляет задачи по Remotion к нужным инструкциям. Он подключает их при создании видео, работе с картами, субтитрами и другими задачами. CX Codex +1 860 000установок remotion-create remotion-dev Скилл remotion-create для Claude Code и Codex разворачивает проект Remotion с нуля. Инициализирует репозиторий через npx create-video и готовит окружение к вёрстке видео на React. CX Codex +1 375 000установок remotion-render 101-skills Скилл remotion-render для Claude Code: принимает TSX-компонент Remotion, запускает рендер через inference.sh и возвращает готовый MP4. CX Codex +1 130 300установок countdown-video iart-ai Скилл countdown-video для Claude Code собирает видео с обратным отсчётом, таймером и цифровыми перекатами в форматах mm:ss или dd:hh:mm:ss. Создаёт экраны «скоро начнём» и отсчёты до запуска. CX Codex +1 3 600установок

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

kinetograph-docs Скилл kinetograph-docs для Claude Code ищет документацию на kinetograph.dev и читает страницы в формате Markdown. Используется при поиске информации о флагах CLI, плагинах или руководствах по Kinetograph. CX Codex +1 ★ 542звёзд репо kinetograph-create Скилл kinetograph-create для Claude Code разворачивает проекты генерации видео и ставит модули из реестра Kinetograph. Включается при создании видео с нуля или по командам init и add. CX Codex +1 ★ 542звёзд репо kinetograph Скилл kinetograph для Claude Code направляет работу с видео и моушн-графикой: выбирает следующий скилл для создания, проверки или рендера. CX Codex +1 ★ 542звёзд репо kinetograph-upgrade Скилл kinetograph-upgrade для Claude Code обновляет CLI kinetograph, пакеты @kinetographdev/* и локальные скиллы агента при несовпадении версий или выходе новых релизов. CX Codex +1 ★ 542звёзд репо kinetograph-studio Скилл kinetograph-studio для Claude Code запускает видеоредактор Kinetograph Studio. Принимает таймлайн, правки по разметке кадров и согласует раскадровки. CX Codex +1 ★ 542звёзд репо kinetograph-render Скилл kinetograph-render для Claude Code проверяет и экспортирует анимации Kinetograph. Помогает смотреть раскадровки, находить ошибки верстки и собирать видео в MP4, MOV или GIF. CX Codex +1 ★ 542звёзд репо kinetograph-markup Скилл kinetograph-markup для Claude Code пишет и меняет сцены Kinetograph в TSX, HTML или JSON для видео. CX Codex +1 ★ 542звёзд репо

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

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