Deepseek ArtifactsDeepseek Artifacts

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

  1. Create the project: npx create-video --yes --blank my-video
  2. Install the skills: npx remotion skills add
  3. Start the preview: npm run dev
  4. Open a second terminal and start your agent: claude (or codex / 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/skills

Creating 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@remotion

Restart 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:

SkillWhat it covers
/remotion-best-practicesEncompasses all the other skills. Use it when you are not sure which specific skill applies.
/remotion-createCreate a new Remotion project or composition.
/remotion-markupBest practices for writing Remotion React markup: compositions, animations, layout, typography, media, effects, audio, fonts, timing.
/remotion-studioLaunch the Studio to preview the video.
/remotion-renderInvoke a render into a video or a still.
/remotion-mapsMap animations: static maps, animated routes and markers, Mapbox, MapLibre, MapTiler, GeoJSON, 3D flyovers with CesiumJS.
/remotion-captionsGuidance for captions and subtitles.
/remotion-saasArchitecture guidance for Remotion-powered apps and product integrations.
/remotion-interactivityMaking Remotion code editable in Studio; use it when elements are not selectable as you want.
/remotion-docsSearch the Remotion documentation and fetch any page as Markdown before implementing.
/remotion-licenseLicence information, FAQs, terms and where to buy a licence (available from v4.0.540).
/remotion-upgradeUpgrade Remotion, related packages, Mediabunny packages and installed Remotion Agent Skills.
/remotion-multimediaBrowser-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

All pages read on 2026-11-17. Remotion is a third-party project and is not affiliated with this site.