Guides / Remotion with a coding agent
Use Claude Code or DeepSeek to write Remotion videos
Remotion renders video from React components, which makes it one of the few video tools a coding agent can drive end to end: it writes a composition, previews it in Studio, then renders an MP4. What the agent usually gets wrong is the current API surface — and that is exactly what Remotion's official Agent Skills exist to fix.
Everything below was read from the official Remotion documentation on 2026-11-17. Commands are copied from those pages; the documentation is the source of truth if anything has moved since.
The short version
- Create the project:
npx create-video --yes --blank my-video - Install the skills:
npx remotion skills add - Start the preview:
npm run dev - Open a second terminal and start your agent:
claude(orcodex/kimi/opencode), then prompt the video.
Remotion's own prerequisite list is a coding agent plus Node.js, and it notes plainly that most coding agents require a paid subscription. If you are driving this with DeepSeek instead of Claude, the flow is identical — the skills are plain Markdown folders, not Claude-specific.
Install the Agent Skills three ways
The skills page offers three install routes, depending on what is already in your project:
# Inside a Remotion project
npx remotion skills add
# No Remotion installed yet — use the generic skills CLI
npx skills add remotion-dev/skills
# Or with the GitHub CLI
gh skill install remotion-dev/skillsCreating a new project also offers to add the skills. Pass --skills to install all of them without the prompt (available from v4.0.541). One caveat from the create-video reference: with --yes, skills are not installed unless you also pass --skills.
The skills also live in the repo at remotion-dev/remotion/packages/skills, so a manual copy works for any agent that reads a skills folder.
If you work in Claude Code, use the plugin
Remotion ships a Claude Code plugin that bundles the same skills. From a terminal:
claude plugin marketplace add remotion-dev/claude-code-plugin
claude plugin install remotion@remotionRestart Claude Code afterwards. Then, in a new session inside your video project, invoke the plugin's create skill with your prompt — Remotion's own example is /remotion:remotion-create Make a promo video for a record store. The plugin source is remotion-dev/claude-code-plugin.
There are official plugins for other agents too — Codex (through the ChatGPT desktop app), Cursor (Cursor Marketplace), GitHub Copilot CLI and Kimi Code. Each one includes the Agent Skills.
What is actually in the skills
Thirteen skills ship in the set. Knowing the names saves you from describing the same task in prose:
| Skill | What it covers |
|---|---|
/remotion-best-practices | Encompasses all the other skills. Use it when you are not sure which specific skill applies. |
/remotion-create | Create a new Remotion project or composition. |
/remotion-markup | Best practices for writing Remotion React markup: compositions, animations, layout, typography, media, effects, audio, fonts, timing. |
/remotion-studio | Launch the Studio to preview the video. |
/remotion-render | Invoke a render into a video or a still. |
/remotion-maps | Map animations: static maps, animated routes and markers, Mapbox, MapLibre, MapTiler, GeoJSON, 3D flyovers with CesiumJS. |
/remotion-captions | Guidance for captions and subtitles. |
/remotion-saas | Architecture guidance for Remotion-powered apps and product integrations. |
/remotion-interactivity | Making Remotion code editable in Studio; use it when elements are not selectable as you want. |
/remotion-docs | Search the Remotion documentation and fetch any page as Markdown before implementing. |
/remotion-license | Licence information, FAQs, terms and where to buy a licence (available from v4.0.540). |
/remotion-upgrade | Upgrade Remotion, related packages, Mediabunny packages and installed Remotion Agent Skills. |
/remotion-multimedia | Browser-based multimedia handling with Mediabunny, e.g. reading video and audio metadata. |
Prompt patterns that work
Remotion's docs give suggested prompts for several skills, and they share a shape: name the skill, name the artefact, name the constraint.
/remotion-create Make a promo video for a record store
/remotion-markup Create an animated title card using Inter.
/remotion-maps Animate a route from Los Angeles to New York and make the camera follow it.
/remotion-saas Turn my video into a SaaS.Two habits make the difference in practice. First, ask for the composition structure before the code — compositions, sequences, duration and fps — because a wrong durationInFrames invalidates every animation after it. Second, tell the agent to call /remotion-docs when it is unsure about a prop, instead of guessing an API from memory.
Feed the agent Markdown, not HTML
The documentation is built for this workflow. Every page has a "Copy as Markdown" button, adding .md to any doc URL returns the raw Markdown, and the site honours the Accept header — so pasting a Remotion doc link into Claude Code, opencode or another agent lets it fetch the Markdown version automatically.
Licence: read this before you ship
Remotion is free for individuals and companies of up to 3 people, including commercial use. Bigger companies need a paid licence, priced by usage on the official pricing page (checked 2026-11-17): a per-render plan for automated video products and a per-seat plan for low-volume manual creation — including using AI agents and Studio. Prices change, so confirm on remotion.dev/docs/license/pricing before you budget. The /remotion-license skill answers the same question from inside the agent.
Where Remotion fits in this site
If you want the prompt side rather than the tooling side, our Opus 5.5 video prompt is built around Remotion compositions. For the skills mechanics themselves — where a SKILL.md lives, how an agent loads it — see the Claude skills tutorial and, for a different vendor's take on the same idea, the Antigravity skills tutorial.
FAQ
Do I need Claude Code specifically?
No. Remotion documents Claude Code, Codex, Cursor, Kimi Code and OpenCode, and the skills install through the generic skills CLI too. The plugin route is Claude Code-only; everything else uses the skills.
Why did my project not get the skills?
Because --yes skips skill installation. Re-run npx remotion skills add inside the project, or scaffold with --skills.
Can I use this commercially?
Free for individuals and companies of up to 3 people; larger companies need a licence. Check the official pricing page — the numbers there are the contract, not this article.
Sources
- remotion.dev/docs/ai — "Building with Remotion and AI": the workflow list and the AI-ready documentation behaviour
- remotion.dev/docs/ai/skills — the three install commands, the 13 skills, the suggested prompts, --skills
- remotion.dev/docs/ai/plugins — the Claude Code, Codex, Cursor, Copilot and Kimi Code plugins
- remotion.dev/docs/ai/claude-code-plugin — the two install commands and the /remotion:remotion-create usage
- remotion.dev/docs/ai/coding-agents — npx create-video --yes --blank, npm run dev, starting the agent
- remotion.dev/docs/cli/create-video — the --yes and --skills flag behaviour
- remotion.dev/docs/license/pricing — free licence scope, company and enterprise licences
All pages read on 2026-11-17. Remotion is a third-party project and is not affiliated with this site.
