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

remotion-script-writer — скилл для Claude Code: видео из кода

Скилл remotion-script-writer анализирует ваше приложение или идею и пишет сценарий Remotion в JSON: сцены с точными таймингами, элементы, анимации, текст и звук. Результат готов к рендеру.

MIT 228 установок ★ 39 обновлён 2026-07-12

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

Что делает remotion-script-writer

remotion-script-writer берёт описание видео (и опционально исходный код вашего приложения) и выдаёт полный сценарий — структурированный JSON с metadata видео, последовательностью сцен, визуальными элементами, анимациями и озвучкой. Каждая цифра в сценарии точна: дюрация сцены в секундах, координаты элементов, скорость анимаций. Два агента, получив один сценарий, создадут идентичные видео.

Скилл работает с пятью типами видео: демо продукта (показ фич приложения), обучающие ролики по коду (с пошаговым разбором), визуализация данных, короткие видео для соцсетей и авторские анимации. Сначала скилл вопрашивает цель видео, целевую аудиторию, тип, продолжительность и стиль; если вы дадите доступ к коду, проанализирует ключевые фичи и выстроит сцены вокруг них. Затем генерирует JSON, готовый для инструмента рендеринга Remotion.

Выход — только сценарий; сам рендер делает Remotion-агент. Скилл требует Remotion на проекте (установка через npm); без него JSON просто ляжет на диск.

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

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

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

  • Напиши сценарий Remotion для видео-демо моего React-приложения из репо github.com/user/myapp
  • Сделай сценарий 30-секундного видео для TikTok про это API, фокусируясь на скорости и точности
  • Напиши сценарий анимированного обучающего видео: как использовать функцию processData() из нашего кода

Как установить remotion-script-writer

1Через Skills CLI (Vercel)

npx skills add sanky369/vibe-building-skills --skill remotion-script-writer -a claude-code

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

~/.claude/skills/remotion-script-writer/SKILL.md

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

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

Вопросы о remotion-script-writer

Как установить remotion-script-writer в Claude Code?

Запусти команду npx skills add sanky369/vibe-building-skills --skill remotion-script-writer -a claude-code, а потом открой ~/.claude/skills/remotion-script-writer/SKILL.md для проверки.

Что выдаёт remotion-script-writer?

JSON-файл с полным сценарием видео: metadata (разрешение, fps, дюрация), список сцен (каждая со своим дизайном, текстом, анимациями), озвучка и перечень нужных ассетов. Этот файл передаёшь инструменту рендеринга Remotion.

Нужно ли давать скиллу исходный код?

Не обязательно. Если код есть, скилл проанализирует приложение и выстроит видео вокруг основных фич. Без кода пишет сценарий на основе описания: что вы хотите показать, кому и зачем.

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

SKILL.md · MIT
---
name: remotion-script-writer
description: "Write a complete, render-ready Remotion video script as structured JSON: analyze the user's codebase or product, break the video into timed scenes, specify every visual element, animation, transition, and voiceover line, and list required assets and Remotion packages. Use whenever the user wants a Remotion video, a programmatic/code-rendered video, a product demo video of their app, an animated coding tutorial, a data-visualization video, or short-form animated social content — trigger on 'make a video of my app', 'Remotion', 'animated demo', 'code walkthrough video', 'render a video from code'. Produces a Remotion Script JSON (videoMetadata, scenes[], requiredAssets, technicalRequirements) that Remotion agent tooling can implement directly."
---

# Remotion Script Writer

Turn a video goal plus (optionally) a codebase into a **Remotion Script JSON** — a scene-by-scene specification precise enough that a Remotion agent can implement it without asking follow-up questions. The governing principle: **the script is the single source of truth for the render** — every duration, element, animation, and voiceover line is stated in numbers and exact strings, never "about 5 seconds" or "some intro text". Two agents given the same input must emit structurally identical scripts.

## When to use / when not to

- Use when the output will be rendered programmatically with Remotion: product demos of web apps, coding tutorials with animated code, motion-graphics pieces, data-visualization videos, short-form social animations.
- Concept and beats not yet decided for a product video → run `skills/creative/product-video` first; its beat sheet becomes this skill's scene list.
- Person-on-camera video → `skills/creative/talking-head` (Remotion is not the tool).
- Static graphics → `skills/creative/social-graphics`.
- This skill writes the script only — implementing the React components, previewing in Remotion Studio, and rendering are done by Remotion's own agent skills downstream.

## Rules files — read before writing the script

- `rules/prompt-structure.md` — the input fields the script is built from (goal, targetAudience, code, videoType, duration, style, animations, transitions). Read it when normalizing intake into the input object.
- `rules/script-generation.md` — the authoritative output JSON structure and generation instructions. Read it before emitting the script; the skeleton below is a summary, that file is the contract.
- `rules/animation-patterns.md` — the approved animation/transition vocabulary with exact JSON shapes and timing guidelines. Read it when specifying any `animation` or `transitionToNextScene` value; do not invent animation types outside it.
- `rules/scene-templates.md` — ready-made scene JSON for common cases (title card, feature showcase, code walkthrough, data viz, outro/CTA). Read it when a scene matches a known pattern; start from the template and edit.
- `examples/product-demo-example.json` — a complete worked script. Read it for calibration on granularity.

## Intake

Ask in one tight batch, only what's missing (field names per `rules/prompt-structure.md`):

1. **goal** and **targetAudience** — what should the video achieve, for whom?
2. **videoType** — `product-demo` | `coding-tutorial` | `animation` | `data-visualization` | `social-media`?
3. **duration** (seconds) and destination platform (decides width/height/fps).
4. **code** — path to the codebase, repo URL, or snippets, if the video features an app or code.
5. **style** — visual/branding constraints (colors, fonts, logo; a `skills/creative/creative-strategist` style guide if one exists).

Infer instead of asking: `language` from the codebase; dimensions from platform (1920×1080 landscape default, 1080×1920 for vertical social, fps 30); animation/transition preferences from `style` if not given. **Don't stall:** with goal + videoType + duration known, state assumptions and proceed.

## Workflow

### 1. Analyze the source material

If `code` is provided, explore it: identify the key features, user flows, data structures, and UI surfaces worth showing. Rank features by relevance to `goal` — the video shows the top 3–5, not everything. If no code, extract the equivalent list from the user's description.

### 2. Structure the scenes

Decision rules by `videoType`:
- **product-demo** → title card → problem/context → one scene per feature (top 3–5) → outro/CTA.
- **coding-tutorial** → title → concept setup → one scene per code step (show code, then explain) → recap.
- **data-visualization** → title → context → one scene per chart/insight → takeaway.
- **social-media** → hook scene (≤3s) → 1–2 payoff scenes → CTA; total ≤60s.
- **animation** → derive beats from the creative concept (or the `skills/creative/product-video` beat sheet).

Timing math is mandatory: scene durations plus transition overlaps must sum exactly to `duration`. `TransitionSeries` transitions overlap adjacent scenes — account for the overlap, don't just add durations. Keep total under ~5 minutes (render performance heuristic).

### 3. Specify each scene completely

For every scene fill every field: `sceneNumber`, `title`, `durationInSeconds`, `visuals.background`, `visuals.elements[]` (type, exact content string, font, size, color, position, `animation` from `rules/animation-patterns.md`), `audio.voiceover` (the exact sentence(s) spoken — verify they fit the scene duration at ~2.5 words/second), and `transitionToNextScene`. Use `rules/scene-templates.md` templates where they match.

### 4. Compile assets and technical requirements

List every image, video clip, audio track, font, and logo referenced by any scene in `requiredAssets` — nothing referenced may be missing from the list. Asset generation is out of scope: mark each as user-provided or describe it precisely; still images can be produced via `skills/creative/image-generation` (repo pipeline: `docs/creative_cli.py`, model `fal-ai/nano-banana-pro`). List `remotionPackages` (e.g. `@remotion/transitions` whenever transitions are used) and any third-party libraries.

### 5. Validate against the quality bar, then deliver the JSON

Deliver the script plus the handoff note (below). The downstream Remotion agent generates components, sets up the composition, previews in Studio, and renders.

## Required output format

Emit one JSON object exactly matching the structure in `rules/script-generation.md`:

```json
{
  "videoMetadata": {
    "title": "...", "durationInSeconds": 60,
    "width": 1920, "height": 1080, "fps": 30,
    "videoType": "product-demo"
  },
  "scenes": [
    {
      "sceneNumber": 1, "title": "...", "durationInSeconds": 5,
      "visuals": {
        "background": "#RRGGBB or asset ref",
        "elements": [
          { "type": "text|image|code|chart", "content": "exact content",
            "animation": { "type": "<from rules/animation-patterns.md>", "durationInSeconds": 1 } }
        ]
      },
      "audio": { "voiceover": "Exact spoken sentence(s)." },
      "transitionToNextScene": { "type": "<from rules/animation-patterns.md>", "durationInSeconds": 1 }
    }
  ],
  "requiredAssets": { "images": [], "videos": [], "audio": [], "fonts": [], "logos": [] },
  "technicalRequirements": { "remotionPackages": [], "thirdPartyLibraries": [] }
}
```

Follow the JSON with a short markdown handoff note: total duration check (scene math shown), the 1–3 assumptions you made, and which assets the user must supply before rendering.

## Quality bar (check before delivering)

- Scene durations + transition overlaps sum exactly to `videoMetadata.durationInSeconds`; show the arithmetic in the handoff note.
- Every `animation` and transition `type` exists in `rules/animation-patterns.md` — no invented types.
- Every voiceover line fits its scene at ~2.5 words/second; no scene has visuals with no purpose stated by the voiceover or title.
- Every asset referenced in any scene appears in `requiredAssets`; fonts used by text elements are listed.
- Remotion correctness baked into the spec: frame-based timing via `useCurrentFrame()`, springs with `damping: 200` for reveals, typewriter via string slicing (not per-character opacity), deterministic randomness only (`random()` from remotion, never `Math.random()`), `premountFor` on heavy sequences, `<Sequence>/<Series>/<TransitionSeries>` for ordering.
- `content` fields are final copy, not placeholders like "feature description here".
- Voiceover is auto-drafted — flag in the handoff note that the user may want to refine it.

## Integration

- `skills/creative/product-video` → feeds in: concept + beat sheet + keyframes for product videos; each beat becomes a scene.
- `skills/creative/creative-strategist` → feeds in: style guide (colors, fonts, mood) applied to `visuals` and `style`.
- `skills/creative/original-design` → feeds in: a design-language brief; every scene's visual vocabulary must come from that world.
- `skills/creative/image-generation` → produces: still assets listed in `requiredAssets.images`.
- `skills/creative/social-graphics` → consumes: rendered stills/thumbnails for post assets.
- Downstream: Remotion agent skills (outside this repo) consume the JSON to build components, preview, and render.

© sanky369 · MIT · sanky369/vibe-building-skills

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
remotion-video iart-ai Скилл remotion-video для сборки MP4, GIF и WebM прямо в React: каждый кадр — чистая функция от useCurrentFrame, поэтому рендер детерминированный и повторяемый. CX Codex +1 5 300установок remotion-best-practices remotion-dev Скилл remotion-best-practices для Claude Code направляет задачи по Remotion к нужным инструкциям. Он подключает их при создании видео, работе с картами, субтитрами и другими задачами. CX Codex +1 860 000установок create-remotion-geist vercel-labs Скилл create-remotion-geist для Claude Code, Cursor, Codex и других агентов, который генерирует Remotion-проекты в визуальном стиле Vercel: тёмная тема, шрифты Geist, пружинные анимации и 10-шаговая цветовая шкала. CX Codex +1 506установок remotion-markup remotion-dev remotion-markup — скилл для Claude Code с рекомендациями по разметке Remotion, анимации и эффектам. Подключается к задачам, где агент пишет или меняет React-композиции для видео. CX Codex +1 367 400установок remotion-video-creation affaan-m Скилл remotion-video-creation подсказывает агенту правила работы с Remotion в React: от анимаций и звука до субтитров, графиков и переходов. Пригодится при сборке видео из React-компонентов. CX Codex +1 6 800установок remotion-motion-graphics haidrrrry Скилл remotion-motion-graphics для ИИ-кодинга, который заставляет агента писать код Remotion по правилам моушн-дизайна, а не выдавать линейные фейды и плоские фоны. CX Codex +1 1 900установок

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

Весь набор →
social-graphics Скилл social-graphics формирует спецификации визуалов для соцсетей с точными пропорциями и текстом, а также генерирует картинки через FAL.ai. CX Codex +1 652установок direct-response-copy Скилл direct-response-copy для Claude Code пишет рекламные тексты с одним целевым действием. Он включается для лендингов, объявлений, писем и страниц продаж. CX Codex +1 415установок tweet-writer Скилл tweet-writer для Claude Code генерирует твиты и треды с нуля, исследуя сначала, что работает в нише, потом предлагая несколько вариантов хуков и полный тред с альтернативами. CX Codex +1 325установок typography-system Скилл typography-system наводит порядок в типографике проекта: собирает модульную шкалу под плотность интерфейса, настраивает интерлиньяж и отдаёт готовые токены для Tailwind или CSS. CX Codex +1 265установок product-video Скилл product-video продумывает сценарий продуктового видео, раскадровку с таймингами и готовые промпты ключевых кадров для генератора fal-ai/nano-banana-pro. CX Codex +1 218установок color-system Скилл color-system для Claude Code собирает цвета проекта в систему токенов и проверяет контраст текста с фоном. Настраивает палитру, исправляет контрастность и добавляет тёмную тему. CX Codex +1 156установок image-generation Скилл image-generation превращает расплывчатые запросы в детальные спецификации промптов и генерирует изображения через FAL.ai и модель nano-banana-pro. CX Codex +1 113установок brand-asset Скилл brand-asset пишет промпт-спеки для логотипов, иконок, паттернов и текстур в едином стиле и генерирует их через FAL.ai, когда задан FAL_API_KEY. CX Codex +1 111установок

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

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