Remotion with Claude Code: set up the skills and make a video
Create a Remotion project, add Remotion’s own agent skills with one command, and prompt Claude Code for a video. The steps come from Remotion’s docs.
- For
- Developers who want Claude Code to make a video with Remotion
- Written for
- Claude Code
- Time
- 8 min read · updated Nov 21, 2026
The short answer
To use Remotion with Claude Code, create a project with npx create-video --yes --blank my-video, go into the folder, and run npx remotion skills add to install Remotion’s agent skills. Start the preview with npm run dev, then run claude in a second terminal in the same folder and ask for the video you want. Remotion’s docs list 13 skills; remotion-best-practices is the one to start from, because it points Claude Code to the others.
Remotion makes video from React code, and Claude Code is good at writing React. What connects the two is a set of agent skills that Remotion publishes itself, so Claude Code writes Remotion code the way the Remotion team recommends instead of guessing. This page follows Remotion’s own setup guide, read on 21 November 2026, and adds what its skills repository contains and what to check as you go.
Set it up, step by step
Step 1: Create a blank project
Remotion’s page uses a blank project, so the agent starts from nothing and builds the composition you ask for. The command needs Node.js; the page does not name a version, so use a current one.
TerminalStep 2: Install the skills and start the preview
Run these inside the project.
npx remotion skills addadds Remotion’s skills for the agents it finds; the next section lists the other ways to install them.npm run devopens Remotion Studio in your browser, which reloads as the agent edits files, so leave it running.TerminalStep 3: Start Claude Code in a second terminal
Open a new terminal window, go to the same folder and start Claude Code. Remotion’s page shows the same line for Codex, Kimi Code and OpenCode, so the setup is not tied to one agent.
Second terminalStep 4: Ask for a video
Remotion’s page gives no example prompts, so these are ours. Say what the video shows, how long it runs and the size, and name the skill if you want to be sure it is used.
Prompt
The other ways to install the skills
Remotion’s skills page gives four commands. They install the same set, so pick by where you are.
The skills command is a general installer, not a Remotion one: it asks which skills and which agents to install to, and a command like npx skills add remotion-dev/skills --skill remotion-render -a claude-code skips the questions. Its README says it installs into the current project unless you add -g. Install a skill in Claude Code covers where Claude Code looks for skills, and Claude skills on GitHub lists what else is in the remotion-dev/skills repository.
The 13 Remotion skills and what each is for
Remotion’s docs list thirteen skills, and the repository at remotion-dev/skills has a SKILL.md for each of the same thirteen names. Skills are loaded when the task matches, so you rarely call them by hand, but the names tell you what Claude Code can do with Remotion.
What “remotion best practices” means here
People searching for “Remotion best practices” are usually after one of two things. The first is the skill of that name. Its own front matter calls it a router for all Remotion skills: it tells the agent which of the others to load for the task, for instance the project setup skill when no Remotion project exists yet, or the markup skill when it is writing the React code. The second is the rules for writing Remotion code, which live in remotion-markup and in Remotion’s documentation, not in this page. Install the skills and let Claude Code read them; that is better than pasting a list of rules into a prompt, because the skills sit in your project and remotion-upgrade exists to keep them current.
Render the finished video
Studio is for previewing. To get a file, ask Claude Code to render it, or run the command yourself. The remotion-render skill says to always pass the composition ID, because without it Remotion shows an interactive picker or fails in a terminal that cannot ask, and gives npx remotion compositions to list the IDs.
Replace <composition-id> with one from the list. The same skill covers passing data into a composition with --props, which is how you make one design render many versions.
Things that go wrong
Claude Code does not mention Remotion and writes plain HTML
The skills did not load or the session started outside the project. Quit, run
claudefrom the project folder, and name/remotion-best-practicesin the prompt.npx remotion renderasks which composition to renderPass the composition ID as the first argument. List the IDs with
npx remotion compositions.The agent overwrote an edit you made
The best-practices skill tells the agent not to overwrite changes you make outside the conversation, but commit before a long session so you can always go back.
You need to update Remotion and the skills
Ask Claude Code to use
/remotion-upgrade. Remotion’s docs say it covers the packages and the installed skills.
Before you install
A skill is instructions your agent follows, and some can run commands, so the safety check is the same for these as for any other. Remotion’s skills come from its own repository, which is a good sign, but you can still open skills/ in remotion-dev/skills and read what is there. Safety checks before running a skill is the short checklist. Remotion’s page does not say how to remove the skills, so if you want them gone, delete their folders from the project.
If you want a finished design instead
Remotion’s skills teach Claude Code the tool. They do not ship a design, so the look of the video is whatever you and the agent build. Lookbk’s video skills work the other way round: each carries a finished design, its timing and its checks, and they are built on HyperFrames, which takes plain HTML and CSS rather than React. If you are choosing between the two, Remotion skill vs HyperFrames skills sets out what each installs and the license each uses, and Remotion alternatives covers the rest. Kinetic Title Drop is free and renders a six-second title.
To try it, run the installer with the last part of the skill page’s address and start a new Claude Code session. How to make videos with Claude Code walks through a first render.
Common questions
- How do I use Remotion with Claude Code?
- Create a blank project with
npx create-video --yes --blank my-video, enter the folder, runnpx remotion skills add, start the preview withnpm run dev, and runclaudein a second terminal in the same folder. Then ask for the video you want. - What does
npx remotion skills adddo? - It installs Remotion’s agent skills for your coding agents. Remotion’s docs also give
npx skills add remotion-dev/skillsfor a project without Remotion,gh skill install remotion-dev/skillsfor the GitHub CLI, andnpx create-video@latest --skillsfor a new project. - Which Remotion skill should I start with?
remotion-best-practices. Remotion’s docs say it covers all the other skills and to use it if you are not sure which one to use; its front matter calls it a router for all Remotion skills.- How many Remotion skills are there?
- Thirteen are listed in Remotion’s docs, and
remotion-dev/skillshas a SKILL.md for each (checked 21 November 2026): best-practices, create, markup, studio, render, maps, captions, saas, interactivity, docs, license, upgrade and multimedia. - Does this only work in Claude Code?
- No. Remotion’s setup page shows the same steps for Claude Code, Codex, Kimi Code and OpenCode, and its skills page says Cursor is supported too. The skills follow the Agent Skills standard.
- How do I render the video Claude Code wrote?
- Run
npx remotion compositionsto list the composition IDs, thennpx remotion render <composition-id> out/video.mp4. Always pass the ID, because without it Remotion asks interactively. - Is Remotion the only way to make video with Claude Code?
- No. HyperFrames renders video from plain HTML and CSS, and it publishes agent skills for Claude Code too. Lookbk’s guide on Remotion skill vs HyperFrames skills compares what each installs and the license each uses.
Sources
What this guide says about other companies’ tools comes from their own documentation, checked on Nov 21, 2026.
Did this guide help?
Read next
All guidesRemotion skill vs HyperFrames skills for Claude Code
Remotion’s official agent skills and HyperFrames’ skills both let Claude Code turn code into video. What each installs, what the agent writes, and the license.
Remotion alternatives for agent-made video (2026)
HyperFrames, Motion Canvas, Revideo and a browser plus FFmpeg, compared with Remotion: what your agent writes, the license, and when to stay put.
How to make videos with Claude Code
Three ways to make MP4 videos with Claude Code: Remotion’s skills, HyperFrames, or a ready-made video skill. Setup, a first render and fixes.
How to install and use Claude skills in Claude Code
How to add skills to Claude Code: paste the install prompt, run one command or unzip the folder, then check it loaded and use it by name or let it trigger.
Claude skills on GitHub: main repos and how to use them
The GitHub repositories that hold Claude skills, checked on the GitHub API: license, last commit, skill count. Then how to copy one into your agent.
Remotion templates: the official starters and what each gives you
Remotion’s own template list: 20 free starters and 3 paid, grouped by job, with the command each starts from, and how a template differs from an agent skill.
See a skill’s result before you install it.
Every skill page shows what it makes, what it needs and which agents can run it.
