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?
| Skill | What it's for | Remotion's suggested prompt |
|---|---|---|
/remotion-best-practices | Router for all the other skills. Use it if you are not sure which one to use. | – |
/remotion-create | Create a new Remotion project or composition. | /remotion-create Make a promo video for a record store |
/remotion-markup | Writing Remotion React markup: compositions, animation, layout, typography, media, effects, audio, fonts, timing. | /remotion-markup Create an animated title card using Inter. |
/remotion-studio | Launch Remotion Studio to preview the video. | /remotion-studio |
/remotion-render | Render a video or a still. | /remotion-render |
/remotion-maps | Map 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-captions | Captions and subtitles. | – |
/remotion-saas | Architecture for Remotion-powered apps and product integrations. | /remotion-saas Turn my video into a SaaS. |
/remotion-interactivity | Making code editable in Studio when elements are not selectable. | – |
/remotion-docs | Search the Remotion docs and fetch any page as Markdown. | /remotion-docs How to set up Remotion Lambda? |
/remotion-license | License information, FAQs, terms and where to buy. | – |
/remotion-upgrade | Upgrade Remotion, related packages and the installed skills. | /remotion-upgrade |
/remotion-multimedia | Browser-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:
/remotion-createA 20-second 1920×1080 launch video at 30 fps for a note-taking app. Logo reveal, three feature lines, end card with the URL. Use Inter. Open Studio when it runs; don't render yet./remotion-markupAdd a spring-animated lower third that slides in at 2 s and out at 6 s. Clamp every interpolate./remotion-captionsAdd word-by-word captions from this transcript, bottom-centred, safe for 9:16./remotion-docsLook up the current props for <Video> from @remotion/media before changing the background clip./remotion-renderRender the composition MyComp to out/launch.mp4.
What are the Remotion best practices for agents?
From the skills' own instructions and Remotion's docs:
- Start with
/remotion-best-practicesif you're unsure which skill applies; it "encompasses all other skills". - 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.
- Keep your edits. The skill tells the agent not to overwrite changes you made outside the conversation.
- Drive everything from
useCurrentFrame(). Animations on their own clock break in Remotion's parallel render (third-party integrations). - Seed randomness with
random('seed'), and clampinterpolate(). - Use
/remotion-docsfor current APIs; Remotion's docs also serve Markdown if you add.mdto any doc URL. - Upgrade together.
/remotion-upgradeupdates 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?
| Symptom | Cause | Fix |
|---|---|---|
| Claude Code doesn't see the skills | Skills 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 answering | Remotion 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 choppy | An 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 different | Math.random() in a component. | Use random() from remotion with a fixed seed. Source |
| Values overshoot at the start or end | interpolate() 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 Agent Skills, Prompting videos with coding agents, npx remotion skills, Claude Code plugin: checked November 10, 2026
- MCP shutdown notice, WebMCP, remotion-dev/skills (best-practices skill v4.0.542): checked November 10, 2026
- Flickering, Timeouts, Remotion system prompt, License FAQ: checked November 10, 2026
