Mapbox

Mapbox Agent Skills

Comprehensive Agent Skills that teach AI assistants how to build fast, beautiful, secure Mapbox applications across Web, iOS, Android, and Flutter platforms. Covers performance optimization, cartographic design, framework integration, platform migration, search integration, geospatial operations, navigation, and security best practices.

Quick Start

Codex Plugin Local Testing

This repository includes a Codex plugin manifest at plugins/mapbox/.codex-plugin/plugin.json and a repo marketplace at .agents/plugins/marketplace.json.

Codex marketplaces currently expect a plugin subdirectory such as plugins/mapbox. To avoid maintaining a second tracked copy of every skill, keep editing the root skills/ directory and generate the local plugin package before testing:

npm run build:codex-plugin
codex plugin marketplace add .
codex plugin marketplace list

Then restart Codex and install the mapbox plugin from the Mapbox Agent Skills marketplace.

The generated plugins/mapbox/skills/ and plugins/mapbox/.mcp.json files are ignored by git.

Open Plugins (Cursor, Codex, GitHub Copilot, Claude Code)

This repository conforms to the Open Plugins specification, making it installable in any conformant tool - Cursor, Codex, GitHub Copilot, Claude Code, and more.

Add the marketplace source:

/plugin marketplace add mapbox/mapbox-agent-skills

Then install the plugin:

/plugin install mapbox

Claude Plugin (Claude Code)

Install as a Claude Code plugin to get skills and MCP servers in one step:

/plugin marketplace add mapbox/mapbox-agent-skills

Then install the plugin:

/plugin install mapbox

This adds all Mapbox skills and connects the mapbox, mapbox-devkit, and mapbox-docs MCP servers automatically.

Skills CLI

Install all Mapbox Agent Skills:

npx skills add mapbox/mapbox-agent-skills

Install specific skills:

npx skills add mapbox/mapbox-agent-skills --skill mapbox-web-performance-patterns

List available skills:

npx skills add mapbox/mapbox-agent-skills --list

💡 Pro tip: These skills work great on their own, but they're even more powerful when combined with the Mapbox MCP DevKit Server. Skills provide the expertise (performance patterns, design principles), while MCP tools provide the actions (create styles, generate previews). Together, they enable complete workflows from design to deployment.