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
npx skills add oakoss/agent-skills --skill remotion -a claude-codeWhat 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-code2Manually: put the files in place
~/.claude/skills/remotion/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/remotion/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill remotion -a codex2Manually: put the files in place
.agents/skills/remotion/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill remotion -a cursor2Manually: put the files in place
.cursor/skills/remotion/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/remotion2Manually: put the files in place
.github/skills/remotion/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill remotion -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/remotionManually: put the files in place
.devin/skills/remotion/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill remotion -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.