Mapbox Agent Skills

This directory contains Agent Skills that provide domain expertise for building maps with Mapbox.

Available Skills

Skill	Description
mapbox-geospatial-operations	Choosing between offline geometric tools and routing APIs for geospatial operations
mapbox-google-maps-migration	Migration guide from Google Maps Platform to Mapbox GL JS with API equivalents and patterns
mapbox-maplibre-migration	Migration guide between Mapbox GL JS and MapLibre GL JS in both directions
mapbox-mcp-devkit-patterns	Integration patterns for Mapbox MCP DevKit Server in AI coding assistants for style management, token management, and validation
mapbox-mcp-runtime-patterns	Integration patterns for Mapbox MCP Server in AI applications with pydantic-ai, mastra, LangChain, and custom agents
mapbox-search-integration	Complete workflow for implementing Mapbox search with discovery questions and best practices
mapbox-search-patterns	Choosing the right search tool and parameters for geocoding and POI search
mapbox-web-performance-patterns	Performance optimization for Mapbox GL JS (initialization, markers, data loading, memory)
mapbox-cartography	Map design principles, color theory, visual hierarchy, typography
mapbox-data-visualization-patterns	Data visualization patterns including choropleth, heat maps, clustering, 3D, and animated data
mapbox-web-integration-patterns	Framework integration (React, Vue, Svelte, Angular, Next.js)
mapbox-ios-patterns	iOS integration with Swift, SwiftUI, UIKit
mapbox-android-patterns	Android integration with Kotlin, Jetpack Compose
mapbox-style-patterns	Common style patterns and layer configurations
mapbox-style-quality	Style validation, accessibility, optimization
mapbox-token-security	Security best practices for access tokens
mapbox-flutter-patterns	Official integration patterns for the Mapbox Maps Flutter SDK (installation, platform setup, camera, annotations, user location)
mapbox-location-grounding	Composing Mapbox MCP tools to produce grounded, cited location-aware responses from live data instead of training data
mapbox-store-locator-patterns	Store locator and location finder patterns with markers, filtering, and distance calculation

Documentation

For full documentation including:

• Detailed skill descriptions and use cases
• Installation instructions for Claude Code, Cursor, VS Code
• Examples and conversation transcripts
• How skills work with Mapbox MCP Server

See the main README.

Contributing

Want to create a new skill or improve an existing one? See the Contributing Guide for:

• Skill structure and format requirements
• Content guidelines and quality standards
• Testing and validation instructions
• Pull request process

Skill Structure

Each skill follows this structure:

skill-name/
├── SKILL.md              # Main skill file (required)
│   ├── YAML frontmatter  # name, description
│   └── Markdown content  # Instructions and guidance
└── [optional files]      # Additional resources

SKILL.md format:

---
name: skill-name
description: What the skill does and when to use it
---
# Skill Name

[Instructions and guidance for AI assistants]

Resources

• Mapbox Documentation