remotion-maps Skill: Animated Maps in Remotion Videos

Helps your agent build animated map shots in Remotion by picking one of five map techniques and following its guide.

Installs: 223.6K; on skills.sh
Stars: 6K; on GitHub
Files: 31; besides SKILL.md
Updated: Oct 2026; last repo commit

The skill tells the agent to pick exactly one technique for the shot you describe, then load only that technique's guide. The five are a static satellite image, Mapbox, MapLibre, MapTiler and CesiumJS. Each directory is self-contained and can be removed without breaking the others.

SKILL.md says Mapbox needs a Mapbox key and MapLibre needs no API key and has no 3D buildings. The technique guides add that MapTiler needs a MapTiler key, and CesiumJS needs a MapTiler key for landscape shots or a billing-enabled Google Map Tiles API key for city shots. The Cesium and MapTiler guides bundle one helper Node script each.

Good for

Video makers who want map reveals, route animations or terrain flythroughs
Remotion developers choosing between Mapbox, MapLibre, MapTiler and Cesium

Install remotion-maps

Claude Code

Copy this prompt.

Install the remotion-maps skill in Claude Code. Run this command:

npx skills add https://github.com/remotion-dev/skills --skill remotion-maps

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Remotion Map animation knowledge

Sections in SKILL.md

[Static map](techniques/static-map/TECHNIQUE.md)
[Mapbox](techniques/mapbox/TECHNIQUE.md)
[MapLibre](techniques/maplibre/TECHNIQUE.md)
[MapTiler](techniques/maptiler/TECHNIQUE.md)
[CesiumJS](techniques/cesium/TECHNIQUE.md)

Key facts

Author: Remotion (remotion-dev), the maker of Remotion
Installs on skills.sh: 223,607 (Nov 2, 2026)
GitHub stars: 6,037 for the remotion-dev/skills repo (Nov 2, 2026)
Last repo commit: Oct 26, 2026
What installs: 31 files: SKILL.md, 5 technique guides, sample components, data and reference notes, a Codex metadata file and an icon; 2 .mjs scripts
Needs: Mapbox: a Mapbox token. MapTiler: a MapTiler key. CesiumJS: a MapTiler key (landscape) or a billing-enabled Google Map Tiles API key (city). MapLibre and static map: no key

What it includes

Use a satellite image in an <Img> tag and animate on top
The simplest route. You supply the image.
Static map
Nicer default styles, a round globe when zoomed out, 3D buildings; needs a Mapbox key
Choose it for polished city shots.
Network · Mapbox
Free, no API key, no 3D buildings
Choose it when you do not want an account or a key.
Network · MapLibre
Annotations over borders, rivers, labels; needs a MapTiler key; bundles prep-geo.mjs
Includes sample components such as a country label and a river reveal.
Runs code · MapTiler
Terrain and city flythroughs; needs a MapTiler or Google key; bundles prep-cesium-path.mjs
Includes notes on 3D data sources, flyover architecture and troubleshooting.
Runs code · CesiumJS

From the official docs

Permissions

Medium risk

The agent may run two bundled Node scripts and use a Mapbox key. Read the scripts first and keep keys in a .env file.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

The Cesium city route needs a billing-enabled Google key
The guide tells you to create a Google Map Tiles API key with billing on, restrict it to that API, and allow local headless Remotion requests. Usage can be charged to your Google account. github.com
Two bundled Node scripts can run on your data
prep-cesium-path.mjs and prep-geo.mjs prepare path and geo files. Read them before you approve a run.
Map routes need your provider keys
Mapbox, MapTiler and Cesium use keys from environment variables. Keep them in a .env file and out of git and chat.

Technical details

Talks to	Map tile and data providers named in the guides

Questions

How do I install remotion-maps?

Use the install box above. The Remotion README also lists npx skills add remotion-dev/skills for the whole set and a GitHub CLI route. The remotion-best-practices skill covers all the others if you are unsure which one to pick.

Does it work in Claude Code, Claude app or Codex?

The Remotion README says its skills are for agents like Claude Code, Codex, Kimi Code and Cursor. It does not document the Claude app. This skill also ships a small Codex display file.

What does remotion-maps do?

It helps the agent pick a map technique for a Remotion shot and follow that technique's guide, from a static image to a 3D terrain flythrough.

Do I need a Mapbox or MapTiler key?

Mapbox needs a Mapbox token (REMOTION_MAPBOX_TOKEN in the guide's example). MapTiler needs a MapTiler key (REMOTION_MAPTILER_KEY). CesiumJS needs a MapTiler key for landscape shots, or a billing-enabled Google Map Tiles API key (REMOTION_GOOGLE_MAPS_API_KEY) for city shots. MapLibre and the static map need none.

Which technique should I pick?

Static map for the simplest case, Mapbox for polished styles and 3D buildings, MapLibre for a free no-key option, MapTiler for labelled rivers or borders, CesiumJS for terrain flythroughs.

Is it safe?

It bundles two Node scripts, prep-cesium-path.mjs and prep-geo.mjs, that read and write JSON files, and the guides use map providers that need keys. The Cesium city route needs a Google API key with billing enabled, so set key restrictions and watch usage. Approve script runs and keep keys in a .env file.

Information

updated Nov 2, 2026

Repository: remotion-dev/skills
Folder: skills/remotion-maps

remotion-dev/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 6

remotion-dev/skills remotion-maps SKILL.md · github.com
remotion-maps mapbox TECHNIQUE.md · github.com
remotion-maps maptiler TECHNIQUE.md · github.com
remotion-maps cesium TECHNIQUE.md · github.com
remotion-maps maplibre TECHNIQUE.md · github.com
remotion-dev/skills README · github.com