Skip to main content
skill CX Codex

remotion · oakoss — Claude Code skill: React video, install

A rulebook for Remotion: your agent builds video out of React components and keeps animation tied to the timeline instead of CSS.

MIT 141 installs ★ 29 updated 2026-08-17

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill remotion -a claude-code
Open on GitHub

What remotion does

This skill hands the agent a rulebook for Remotion, the library that turns React components into video. A composition declares its own width, height, fps and duration. Motion comes from useCurrentFrame() and interpolate(); keyframes and Tailwind animation classes leave artifacts in the render.

Inside sits a pattern table plus a list of common mistakes. Springs via spring(), Sequence and Series, TransitionSeries for transitions, media from @remotion/media, ThreeCanvas for 3D, a Zod schema on <Composition schema>, transparent WebM with --pixel-format=yuva420p --codec=vp9. Reference files cover animation, sequencing, media, captions and transitions; hunting down existing compositions is handed to the Explore subagent.

You need a React project that already uses Remotion. Everyday UI work is outside its scope, so it will not help with a plain React frontend. Mapbox rendering runs with --gl=angle --concurrency=1, and the Zod schema on a composition wants the exact Zod version Remotion documents.

What it helps with

  • define a composition with explicit width, height and fps
  • add a spring animation that doesn't bounce
  • stitch scenes with fade or slide and get the total duration right
  • render TikTok-style captions with word highlighting
  • drop a 3D scene in through ThreeCanvas

Example prompts for the agent

  • Build a Remotion composition where the title slides in from the left and the background fades.
  • Add a fade transition between the two scenes and tell me the final duration.
  • Render the Mapbox composition to WebM with a transparent background.

How to install remotion

1Skills CLI (Vercel)

npx skills add oakoss/agent-skills --skill remotion -a claude-code

2Manually: put the files in place

~/.claude/skills/remotion/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/remotion/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about remotion

How do I install remotion in Claude Code?

Run npx skills add oakoss/agent-skills --skill remotion -a claude-code; the skill then sits at ~/.claude/skills/remotion/SKILL.md.

What does the remotion skill do?

It tells the agent how to assemble video from React components: compositions with explicit dimensions and fps, frame-driven animation, transitions, audio, captions and rendering.

Why does it rule out CSS animations?

Animation has to come from useCurrentFrame(). Keyframes and Tailwind classes bypass that timeline and leave artifacts in the render.

Source text

SKILL.md · MIT
---
name: remotion
description: 'Best practices for Remotion - Video creation in React. Use when creating programmatic videos with Remotion, adding animations or transitions, working with audio/captions, rendering compositions, embedding 3D content, building charts, or using Mapbox maps in video.'
license: MIT
metadata:
  author: oakoss
  version: '1.0'
  source: 'https://www.remotion.dev/docs'
user-invocable: false
---

# Remotion

## Overview

Remotion enables programmatic video creation using React components. Compositions define renderable videos with explicit width, height, fps, and duration. All animations must be driven by `useCurrentFrame()` -- CSS animations and Tailwind animation classes are forbidden as they cause rendering artifacts. Use this skill for Remotion compositions, animations, audio, captions, transitions, media handling, or rendering. Not intended for general React UI development.

## Quick Reference

| Pattern           | API / Approach                                                      | Key Points                                                                            |
| ----------------- | ------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| Basic animation   | `useCurrentFrame()` + `interpolate()`                               | Always clamp with `extrapolateRight: 'clamp'`                                         |
| Spring animation  | `spring({ frame, fps })`                                            | `{ damping: 200 }` for smooth, no-bounce motion                                       |
| Composition       | `<Composition id, component, durationInFrames, fps, width, height>` | Always set explicit dimensions                                                        |
| Dynamic metadata  | `calculateMetadata` on `<Composition>`                              | Set duration, dimensions, props before render                                         |
| Sequencing        | `<Sequence from, durationInFrames>`                                 | `useCurrentFrame()` returns local frame (starts at 0)                                 |
| Series            | `<Series>` with `<Series.Sequence>`                                 | Sequential playback; negative offset for overlaps                                     |
| Transitions       | `<TransitionSeries>` with `fade()`, `slide()`, `wipe()`             | Total duration = sum of scenes minus transition durations                             |
| Audio/Video       | `<Audio>` / `<Video>` from `@remotion/media`                        | Use `staticFile()` for local assets                                                   |
| Captions          | `createTikTokStyleCaptions()`                                       | Token-level word highlighting via `page.tokens`                                       |
| Images            | `<Img>` from `remotion`                                             | Never use native `<img>` or Next.js `<Image>`                                         |
| GIFs              | `<AnimatedImage>` from `remotion`                                   | Synced with timeline; `playbackRate` for speed control                                |
| Fonts             | `@remotion/google-fonts` or `@remotion/fonts`                       | Call `loadFont()` at top level; blocks rendering until ready                          |
| 3D content        | `<ThreeCanvas>` from `@remotion/three`                              | Must set `width`/`height`; `useFrame()` from R3F is forbidden                         |
| Text measurement  | `measureText()`, `fitText()` from `@remotion/layout-utils`          | Load fonts first; match properties for measurement and render                         |
| Parameters        | Zod schema on `<Composition schema>`                                | Top-level must be `z.object()`; exact Zod version required (check Remotion docs)      |
| Transparent video | `--pixel-format=yuva420p --codec=vp9`                               | WebM for browser; ProRes 4444 for editing software                                    |
| Maps              | Mapbox with `useCurrentFrame()`                                     | Set `interactive: false`, `fadeDuration: 0`; render with `--gl=angle --concurrency=1` |

## Common Mistakes

| Mistake                                                         | Correct Pattern                                                            |
| --------------------------------------------------------------- | -------------------------------------------------------------------------- |
| Using CSS animations or `setTimeout`                            | Use `interpolate()` and `useCurrentFrame()` for timeline-synced animations |
| Using native `<img>`, `<video>`, `<audio>` tags                 | Use `<Img>`, `<Video>`, `<Audio>` from Remotion for proper preloading      |
| Hardcoding video duration                                       | Use `calculateMetadata` to dynamically set duration from content           |
| Not specifying width/height on compositions                     | Always define explicit dimensions to avoid rendering issues                |
| Using `useFrame()` from React Three Fiber                       | Use `useCurrentFrame()` from Remotion inside `<ThreeCanvas>`               |
| Forgetting `premountFor` on sequences                           | Always premount sequences to preload components before playback            |
| Not clamping `interpolate()` output                             | Set `extrapolateRight: 'clamp'` to prevent values exceeding target range   |
| Placing `<Sequence>` in `<ThreeCanvas>` without `layout="none"` | Set `layout="none"` on any `<Sequence>` inside `<ThreeCanvas>`             |

## Delegation

- **Discover available Remotion components and their props**: Use `Explore` agent to search the codebase for composition definitions and asset usage
- **Build a multi-scene video with transitions and audio**: Use `Task` agent to compose sequences, transitions, and audio tracks step by step
- **Plan a video generation pipeline with dynamic data**: Use `Plan` agent to design the architecture for parametrized compositions and rendering workflow

## References

- [Animations and Timing](references/animations-and-timing.md) -- Interpolation, springs, easing, and frame-driven animation patterns
- [Compositions and Sequencing](references/compositions-and-sequencing.md) -- Defining compositions, stills, folders, sequences, series, and trimming
- [Media and Assets](references/media-and-assets.md) -- Audio, video, images, GIFs, fonts, and static file handling
- [Captions and Text](references/captions-and-text.md) -- Transcription, SRT import, TikTok-style captions, and text animations
- [Transitions](references/transitions.md) -- Scene transitions with fade, slide, wipe, flip, and duration calculation
- [Advanced Features](references/advanced-features.md) -- 3D content, charts, maps, parameters, transparent video, and DOM measurement

© oakoss · MIT · oakoss/agent-skills

Similar skills

All skills for Frontend and UI →

remotion by other authors comes first.

remotion official google-labs-code remotion is a Claude Code skill that turns Stitch project screens into a Remotion walkthrough video. It arranges screenshots with transitions, zoom effects, and captions. CX Codex +1 43,100installs remotion nexu-io This skill tells the agent that React-based video generation is available through Remotion and lists trigger phrases for invoking it. Useful when building explainers, social clips or data-driven video. CX Codex +1 3,100installs remotion calesthio Teaches AI agents toolkit-specific Remotion patterns, including custom transition shaders and 30 fps video rules. CX Codex +1 1,300installs remotion vercel-labs Turns JSON timeline specs into ready-made video compositions via Remotion. Use it when you need to generate videos programmatically or assemble video clip catalogs from data. CX Codex +1 1,800installs remotion podo remotion is a Claude Code skill for building videos from React components, with spring-driven motion and export to MP4, WebM or GIF. CX Codex +1 265installs remotion-video-toolkit shreefentsar remotion-video-toolkit — a skill that teaches your AI agent to write Remotion code: animations, timing, MP4 rendering, captions, charts and 3D. Useful when video comes from data instead of a timeline editor. CX Codex +1 804installs remotion-captions remotion-dev remotion-captions — a skill for Claude Code and Cursor that handles video subtitles in Remotion. It directs transcription, timing generation, and animated text display. CX Codex +1 373,700installs remotion-best-practices remotion-dev remotion-best-practices is a Claude Code skill that routes Remotion tasks to relevant instructions. It covers video creation, maps, captions, and other workflows. CX Codex +1 860,000installs remotion-motion-graphics haidrrrry remotion-motion-graphics — a coding-agent skill that makes Remotion code follow motion design rules instead of shipping linear fades and flat backgrounds. CX Codex +1 1,900installs create-remotion-geist vercel-labs create-remotion-geist — a skill for Claude Code, Cursor, Codex and other agents that scaffolds Remotion projects in Vercel's visual style: dark backgrounds, Geist typography, spring animations, and the 10-step color scale. CX Codex +1 506installs remotion-script-writer sanky369 The remotion-script-writer skill reads your app or concept and writes a Remotion script in JSON: timed scenes, visual elements, animations, voiceover text. Ready to render immediately. CX Codex +1 228installs

From the same set106

The whole set →
chrome-devtools chrome-devtools is a Claude Code skill that controls a real Chrome session through an extension or DevTools MCP to fill forms, inspect pages, and debug web apps. It works with an existing browser session. CX Codex +1 145installs hydration-guardian hydration-guardian finds where server-rendered HTML and the client React tree disagree, then points to the pattern that fixes it. CX Codex +1 144installs e2e-testing e2e-testing guides AI coding assistants on Playwright E2E test suite architecture, Page Object Models, network mocking, and CI sharding strategies. CX Codex +1 142installs valkey This skill guides Valkey setup for caching, rate limits, queues, and Redis migration. Use it when choosing data patterns or configuring a Docker Compose service. CX Codex +1 142installs vite A skill for Vite work: config file, plugins, dev server, build output, SSR and env variables. Useful when the agent edits vite.config.ts in your project. CX Codex +1 138installs postgres-tuning postgres-tuning — a skill for Claude Code, Codex, Cursor and other agents that provides PostgreSQL 17/18+ performance tuning guidance. Covers async I/O, query plan forensics, index strategy, autovacuum, pgvector, and connection pooling. CX Codex +1 136installs tanstack-db Get guidance on TanStack DB collections, live queries, and optimistic writes. Useful when a UI needs reactive local data or explicit sync with a backend. CX Codex +1 136installs prompt-engineering prompt-engineering is a Claude Code skill for prompt design, covering reasoning chains, ReAct loops, system prompt layouts, extended thinking and context trimming. CX Codex +1 135installs

Project sponsors

Companies that keep this analytics open