Remotion + Claude Code

Remotion Claude skills install, prompt, fix

Remotion publishes Agent Skills that teach Claude Code, Codex and Cursor how to write Remotion video code. Here are the install commands exactly as Remotion documents them, every skill, prompts, best practices and fixes for the errors you'll hit.

Commands copied from Remotion's docs, checked November 10, 2026

Remotion Claude skills: install, prompt, fix
Remotion's Claude skills are 13 official Agent Skills that teach a coding agent Remotion's rules for compositions, animation, preview and rendering. Install them with npx skills add remotion-dev/skills (or npx remotion skills add inside a project), restart Claude Code, and start with /remotion-best-practices or /remotion-create. The skills are free; the Remotion licence still applies.

What are Remotion's agent skills?

Agent Skills are instruction files a coding agent loads when a task matches. Remotion maintains a set that "define best practices for working in Remotion projects", for Claude Code, Codex, Kimi Code and Cursor (Remotion docs). They tell the agent things a generic model gets wrong: drive every animation from the frame number, seed randomness, open a preview instead of rendering straight away, and look up current APIs rather than guessing. The source is on GitHub at remotion-dev/skills.

How do you add Remotion skills to Claude Code?

Remotion documents four ways. Pick one.

Option 1: the skills CLI (any project)

npx skills add remotion-dev/skills

Or with the GitHub CLI: gh skill install remotion-dev/skills.

Option 2: a new project, step by step

From Remotion's coding agents guide:

npx create-video --yes --blank my-video
cd my-video
npx remotion skills add
npm run dev

Then open a second terminal in my-video and run claude. npx remotion skills update refreshes them later (CLI reference). You can also run bun create video, which offers the skills when it creates the project.

Option 3: the Claude Code plugin

claude plugin marketplace add remotion-dev/claude-code-plugin
claude plugin install remotion@remotion

Restart Claude Code, then prompt /remotion:remotion-create Make a promo video for a record store. In the Claude desktop app, the same plugin is under Code → Customize → Plugins → Discover; search for "remotion" (plugin docs).

Prerequisites

Node.js and a coding agent. Remotion notes that "most coding agents require a paid subscription".

Which Remotion skills are there?

SkillWhat it's forRemotion's suggested prompt
/remotion-best-practicesRouter for all the other skills. Use it if you are not sure which one to use.–
/remotion-createCreate a new Remotion project or composition./remotion-create Make a promo video for a record store
/remotion-markupWriting Remotion React markup: compositions, animation, layout, typography, media, effects, audio, fonts, timing./remotion-markup Create an animated title card using Inter.
/remotion-studioLaunch Remotion Studio to preview the video./remotion-studio
/remotion-renderRender a video or a still./remotion-render
/remotion-mapsMap animations: routes, markers, Mapbox, MapLibre, GeoJSON, 3D flyovers with CesiumJS./remotion-maps Animate a route from Los Angeles to New York and make the camera follow it.
/remotion-captionsCaptions and subtitles.–
/remotion-saasArchitecture for Remotion-powered apps and product integrations./remotion-saas Turn my video into a SaaS.
/remotion-interactivityMaking code editable in Studio when elements are not selectable.–
/remotion-docsSearch the Remotion docs and fetch any page as Markdown./remotion-docs How to set up Remotion Lambda?
/remotion-licenseLicense information, FAQs, terms and where to buy.–
/remotion-upgradeUpgrade Remotion, related packages and the installed skills./remotion-upgrade
/remotion-multimediaBrowser-based media handling with Mediabunny, such as video and audio metadata.–

From remotion.dev/docs/ai/skills, November 10, 2026. With the plugin, prefix the skill with remotion:, as in /remotion:remotion-create.

What prompts work well with Remotion skills?

Remotion's own suggestions are in the table above, and its Prompt Showcase collects community videos made with the skills (product demos, map routes, chart animations, launch videos). Prompts that leave less to guess tend to need fewer rounds. These are our examples, written to follow Remotion's guidance, not copied from its docs:

What are the Remotion best practices for agents?

From the skills' own instructions and Remotion's docs:

  1. Start with /remotion-best-practices if you're unsure which skill applies; it "encompasses all other skills".
  2. Preview before rendering. The skill tells the agent not to render unless you ask explicitly, and to start Studio and open the preview first, so you can watch and steer.
  3. Keep your edits. The skill tells the agent not to overwrite changes you made outside the conversation.
  4. Drive everything from useCurrentFrame(). Animations on their own clock break in Remotion's parallel render (third-party integrations).
  5. Seed randomness with random('seed'), and clamp interpolate().
  6. Use /remotion-docs for current APIs; Remotion's docs also serve Markdown if you add .md to any doc URL.
  7. Upgrade together. /remotion-upgrade updates Remotion, its packages and the installed skills in one go.

One extra tool: Remotion Studio exposes WebMCP tools (from v4.0.518) so an agent can inspect selections, seek the playhead and read errors. Remotion says only ChatGPT Codex supports WebMCP among the major agents for now.

What are the common errors, and how do you fix them?

SymptomCauseFix
Claude Code doesn't see the skillsSkills were installed while the agent was running, or outside the project folder.Restart Claude Code (Remotion's docs say so). Skills live in .agents/skills, symlinked to .claude/skills. Source
The remotion-documentation MCP server stopped answeringRemotion shut its hosted MCP down on October 26, 2026.Remove it from your MCP config, run npx remotion skills add, and ask for /remotion-docs. Source
The render flickers or is choppyAn animation runs off a CSS clock, timer or library instead of useCurrentFrame(). Remotion renders in several tabs at once.Drive every value from useCurrentFrame(); sync CSS animations with animation-play-state and animation-delay. Source
"A delayRender() was called but not cleared after 28000ms"continueRender() never ran, an asset or font couldn't load, or memory pressure.Make sure continueRender() is called; check network access in the cloud; lower concurrency. Source
Timeout loading an <OffthreadVideo> frame<OffthreadVideo> downloads the whole file before extracting a frame.Switch to <Video> from @remotion/media, or raise the timeout. Source
Every render looks slightly differentMath.random() in a component.Use random() from remotion with a fixed seed. Source
Values overshoot at the start or endinterpolate() extrapolates past its range by default.Pass extrapolateLeft and extrapolateRight: "clamp". Source

Does using Remotion with Claude need a licence?

The skills are free, but Remotion's licence is unchanged by how the code was written. Remotion for Creators is "$25/month per person who writes Remotion code themselves or using agentic coding tools", for companies above 3 people (License FAQ). There is even a /remotion-license skill for questions. The full rules are on Is Remotion free?

What other frameworks have Claude skills?

HeyGen's HyperFrames ships 9 skills and a Claude Code plugin (claude plugin install hyperframes@hyperframes) for writing video as plain HTML, under Apache 2.0. Motion Canvas and Revideo publish none. See Remotion vs HyperFrames and Remotion alternatives. If you'd rather skip code entirely, see AI motion graphics tools.

Sources

Remotion Claude skills FAQ

How do I install Remotion skills in Claude Code?
Run npx skills add remotion-dev/skills in your project, or npx remotion skills add inside an existing Remotion project, then restart Claude Code. You can also install the Claude Code plugin with claude plugin marketplace add remotion-dev/claude-code-plugin and claude plugin install remotion@remotion.
What does npx skills add remotion-dev/skills do?
It installs Remotion's 13 Agent Skills, instruction files that tell a coding agent how to write, preview and render Remotion code correctly. Remotion also lists gh skill install remotion-dev/skills as an alternative, and bun create video offers the skills when you start a project.
Where are Remotion skills installed?
npx remotion skills add puts them in the .agents/skills folder of your project. Remotion makes them work in Claude Code by symlinking .claude/skills to .agents/skills.
Is there a Remotion MCP server?
Not any more. Remotion shut its hosted MCP server down on October 26, 2026, saying agents did not invoke it reliably and it duplicated the /remotion-docs skill. Remotion Studio does expose WebMCP tools, but Remotion says only ChatGPT Codex supports WebMCP among the major agents.
Do Remotion skills cost anything?
The skills are free. The usual Remotion licence still applies: free for individuals and companies of up to 3 people, otherwise $25 a month per person writing Remotion code, which Remotion says includes using agentic coding tools. Your coding agent's own subscription is separate.
Which Remotion skill should I use first?
Start with /remotion-best-practices, which routes to the others, or /remotion-create to scaffold a new video. Use /remotion-docs whenever the agent needs current API details.

Want the finished film without writing code?

Paste your product link.