mapbox-maplibre-migration

mapbox-maplibre-migration is a skill for Claude Code, Codex from mapbox/mapbox-agent-skills. It costs 43 tokens per session (3,678 once invoked), scanned A, original, MIT.

A migration guide for changing web maps from MapLibre GL JS to Mapbox GL JS. MapLibre is an open-source map library, while Mapbox provides its own map platform and services.

In plain words
What is it for?
Use it when replacing MapLibre with Mapbox in a web mapping project and checking which existing map code can be retained.
Why use it?
It explains the compatibility, code changes, access token setup and style configuration involved in moving between the two libraries.

Skill for Claude CodeCodex

Part of the mapbox plugin — 20 skills, 3 MCP servers shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/mapbox/mapbox-agent-skills/mapbox-maplibre-migration
Any agent
npx skills add mapbox/mapbox-agent-skills --skill mapbox-maplibre-migration
Clone the repo
git clone --depth 1 https://github.com/mapbox/mapbox-agent-skills

Made for: Claude Code, Codex.

Or install mapbox, the plugin that ships this one along with the rest of its 20 skills, 3 MCP servers.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for mapbox-maplibre-migration

README.md
[![agentmods](https://agentmods.dev/badge/skills/mapbox/mapbox-agent-skills/mapbox-maplibre-migration.svg)](https://agentmods.dev/skills/mapbox/mapbox-agent-skills/mapbox-maplibre-migration)
Your own site
<a href="https://agentmods.dev/skills/mapbox/mapbox-agent-skills/mapbox-maplibre-migration"><img src="https://agentmods.dev/badge/skills/mapbox/mapbox-agent-skills/mapbox-maplibre-migration.svg" alt="Measured on agentmods" height="20"></a>
Per session 43 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,678 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00043 $0.03678
Opus 5 $0.00022 $0.01839
Sonnet 5 $0.00009 $0.00736
Haiku 4.5 $0.00004 $0.00368

Measured 5d ago against content hash d123cd928616, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

mapbox-maplibre-migration scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

skills/mapbox-maplibre-migration/SKILL.md · 426 lines

How it starts

The opening of the file, as written. The whole thing — 426 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MapLibre to Mapbox Migration Skill

Expert guidance for migrating from MapLibre GL JS to Mapbox GL JS. Covers the shared history, API compatibility, migration steps, and the advantages of Mapbox's platform.

Understanding the Fork

History

MapLibre GL JS is an open-source fork of Mapbox GL JS v1.13.0, created in December 2020 when Mapbox changed their license starting with v2.0.

Timeline:

  • Pre-2020: Mapbox GL JS was open source (BSD license)
  • Dec 2020: Mapbox GL JS v2.0 introduced proprietary license
  • Dec 2020: Community forked v1.13 as MapLibre GL JS
  • Present: Both libraries continue active development

Key Insight: The APIs are ~95% identical because MapLibre started as a Mapbox fork. Most code works in both with minimal changes, making migration straightforward.

Why Migrate to Mapbox?

Compelling reasons to choose Mapbox GL JS:

  • Official Support & SLAs: Enterprise-grade support with guaranteed response times
  • Superior Tile Quality: Best-in-class vector tiles with global coverage and frequent updates
  • Better Satellite Imagery: High-resolution, up-to-date satellite and aerial imagery
  • Rich Ecosystem: Seamless integration with Mapbox Studio, APIs, and services
  • Advanced Features: Traffic-aware routing, turn-by-turn directions, premium datasets
  • Geocoding & Search: World-class address search and place lookup
  • Navigation SDK: Mobile navigation with real-time traffic
  • No Tile Infrastructure: No need to host or maintain your own tile servers
  • Regular Updates: Continuous improvements and new features
  • Professional Services: Access to Mapbox solutions team for complex projects

Mapbox offers a generous free tier: 50,000 map loads/month, making it suitable for many applications without cost.

Quick Comparison

Aspect Mapbox GL JS MapLibre GL JS
License Proprietary (v2+) BSD 3-Clause (Open Source)
Support Official commercial support Community support
Tiles Premium Mapbox vector tiles OSM or custom tile sources
Satellite High-quality global imagery Requires custom source
Token Required (access token) Optional (depends on tile source)
APIs Full Mapbox ecosystem Requires third-party services
Studio Full integration No native integration
3D Terrain Built-in with premium data Available (requires data source)
Globe View v2.9+ v3.0+
API Compatibility ~95% compatible with MapLibre ~95% compatible with Mapbox
Bundle Size ~500KB ~450KB
Setup Complexity Easy (just add token) Requires tile source setup

Read the full file on GitHub · 426 lines

Files

What ships with it

5 files beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 5d ago First seen · 426 lines · 43 tokens per session scan A d123cd928616

Subscribe to this mod's changes

mapbox-maplibre-migration is a skill published in the GitHub repository mapbox/mapbox-agent-skills (75 stars, last pushed 10d ago), licensed MIT. It adds 43 tokens to every session and 3,678 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

zoom-meeting-sdk-web-component-view

Zoom Meeting SDK Web - Component View. Embeddable Zoom meeting components with Promise-based API for flexible integration. Ideal for React/Vue/Angular apps and custom layouts. Uses ZoomMtgEmbedded with async/await patterns and embeddable UI containers.

anthropics/knowledge-work-plugins · 61 tokens

ui-toolkit/web

Reference skill for Zoom Video SDK UI Toolkit. Use after routing to a web video workflow when you want prebuilt React UI instead of building a fully custom Video SDK interface.

anthropics/knowledge-work-plugins · 39 tokens

astro

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

sickn33/agentic-awesome-skills · 28 tokens

tanstack-form

Headless, performant, and type-safe form state management for TS/JS, React, Vue, Angular, Solid, Lit, and Svelte.

Kiranism/next-shadcn-dashboard-starter · 34 tokens

create-site

Creates a new Power Pages code site (SPA) using React, Angular, Vue, or Astro. Guides through the full process from initial concept to deployed site: requirements discovery, scaffolding, component planning, design, implementation, validation, and deployment. Use when the user wants to create, build, or scaffold a new…

microsoft/power-platform-skills · 73 tokens

web-development

Use when users need to implement, integrate, debug, build, deploy, or validate a Web frontend after the product direction is already clear, especially for React, Vue, Vite, browser flows, or CloudBase Web integration.

TencentCloudBase/CloudBase-AI-Toolkit · 49 tokens