mapbox/mapbox-agent-skills
19 skills23.1k installs1.3k starsGitHub
Install
npx skills add https://github.com/mapbox/mapbox-agent-skillsSkills in this repo
1Mapbox Web Integration PatternsThe mapbox-web-integration-patterns skill documents Mapbox GL JS and Search JS integration for web apps. Covers CDN and npm installs version migration v2 to v3 framework minimums React 16.8 plus Vue Svelte Angular Next.js 13 App Router create-web-app scaffolds. Search JS packages differ for React versus other frameworks. Use embedding maps geocoding search widgets and web map patterns with correct GL JS CSS script tags and framework-specific setup for production Mapbox web integrations. Mapbox GL JS CDN and npm integration. Search JS React vs web packages. Framework mins React Vue Svelte Angular Next. create-web-app scaffolds current versions. v2 to v3 migration notes. Mapbox web integration patterns. User asks Mapbox GL JS web integration.1.8kinstalls2Mapbox Web Performance PatternsThis skill provides patterns for optimizing Mapbox GL JS performance across critical workflows: eliminating initialization waterfalls by parallelizing data loading with map setup, reducing bundle size by externalizing style JSON, and optimizing marker rendering via symbol layers and clustering instead of HTML markers. Developers use it when building map-heavy applications to hit targets like sub-2-second time-to-interactive on 3G and 60 FPS pan/zoom. Patterns prioritize by impact: critical waterfalls and bundle bloat first, then marker optimization, then interactions and memory cleanup.1.7kinstalls3Mapbox Style PatternsMapbox Style Patterns provides battle-tested style and layer configurations for six common mapping scenarios: restaurant/POI finders, real estate, data visualization, navigation, dark mode, and delivery/logistics tracking. Developers use this skill to avoid building styles from scratch by reference a pattern library with specific layer recipes, zoom-optimized filters, and visual requirements for each use case. Key workflows include selecting the appropriate pattern via a decision tree based on content type and viewing environment, implementing the recommended layer stack with correct paint properties and filters, and testing across zoom levels and device sizes using the provided checklist.1.7kinstalls4Mapbox Geospatial Operationsmapbox-geospatial-operations is an agent skill from mapbox/mapbox-agent-skills that expert guidance on choosing the right geospatial tool based on problem type, accuracy requirements, and performance needs. # Mapbox Geospatial Operations Skill Expert guidance for AI assistants on choosing the right geospatial tools from the Mapbox MCP Server. Focuses on selecting tools based on **what the problem requires** - geometric calculations vs routing, straight-line vs road network, and accuracy needs. ## Core Principle: Problem Type Determines Tool Choice Developers invoke mapbox-geospatial-operations during build/integrations work for ai & agent building tasks. The skill documents triggers, prerequisites, and step-by-step workflows grounded in SKILL.md. Compatible with Claude Code, Cursor, and Codex agent runtimes that load marketplace skills. Review the Security Audits panel on this listing before installing in production environments.1.6kinstalls5Mapbox CartographyThe mapbox-cartography skill provides expert cartographic guidance for designing effective Mapbox map styles with visual hierarchy, color theory, typography, and accessibility. Visual hierarchy ranks POIs and routes as most important, major roads secondary, minor streets tertiary, and water or terrain as background using size, contrast, and color intensity. Color guidance covers analogous, complementary, and monochromatic palettes with psychology notes for blue water, green parks, and gray roads. Light, dark, and high-contrast palette templates include JSON color specs with dark theme road rule using neutral #3a3a3a not colored hues. Accessibility requires 4.5:1 contrast, colorblind-safe distinctions, and no red-green-only encoding. Use when designing map styles, choosing colors, or making cartographic decisions in Mapbox.1.5kinstalls6Mapbox Data Visualization PatternsThe mapbox-data-visualization-patterns skill is designed for patterns for visualizing data on maps including choropleth maps, heat maps, 3D visualizations, data-driven styling, and animated data. Covers layer types, color scales, and. Data Visualization Patterns Skill Comprehensive patterns for visualizing data on Mapbox maps. Covers choropleth maps, heat maps, 3D extrusions, data-driven styling, animated visualizations, and performance optimization for data-heavy applications. Invoke when the user asks about mapbox data visualization patterns or related SKILL.md workflows.1.5kinstalls7Mapbox Style QualityThe mapbox-style-quality skill is designed for expert guidance on validating, optimizing, and ensuring quality of Mapbox styles through validation, accessibility checks, and optimization. Use when preparing styles for. Mapbox Style Quality Skill This skill provides expert guidance on ensuring Mapbox style quality through validation, accessibility, and optimization tools. When to Use Quality Tools Pre-Production Checklist Before deploying any Mapbox style to production: 1. Invoke when the user preparing styles for production, debugging issues, or ensuring map quality standards.1.4kinstalls8Mapbox Token SecurityThe mapbox-token-security skill security best practices for Mapbox access tokens including scope management URL restrictions rotation strategies and protecting sensitive data Use when creating managing or advising on Mapbox token security Mapbox Token Security Skill This skill provides security expertise for managing Mapbox access tokens safely and effectively Token Types and When to Use Them Public Tokens pk Characteristics Can be safely exposed in client-side code Limited to specific public scopes only Can have URL restrictions Cannot access sensitive APIs When to use Client-side web applications Mobile apps Public-facing demos Embedded maps on websites Allowed scopes styles tiles Display style tiles raster styles read Read style specifications fonts read Access Mapbox fonts datasets read Read dataset data vision read Vision API access Secret Tokens sk Characteristics NEVER expose in client-side code Full API access with any scopes Server-side use only Can create manage other tokens When to use Server-side applications Backend services CI CD pipelines Administrative tasks Token management Common scopes styles write Create modify styles styles list List all1.3kinstalls9Mapbox Search IntegrationThe mapbox-search-integration skill complete workflow for implementing Mapbox search in applications - from discovery questions to production-ready integration with best practices # Mapbox Search Integration Skill Expert guidance for implementing Mapbox search functionality in applications. Covers the complete workflow from asking the right discovery questions, selecting the appropriate search product, to implementing production-ready integrations following best practices from the Mapbox search team. ## Use This Skill When User says things like: - "I need to add search to my map" - "I need a search bar for my mapping app" - "How do I implement location search?" - "I want users to search for places/addresses" - "I need geocoding in my application" **This skill complements `mapbox-search-patterns`:** - `mapbox-search-patterns` = Tool and parameter selection - `mapbox-search-integration` = Complete implementation workflow ## Discovery Phase: Ask the Right Questions Before jumping into code, ask these questions to understand requirements: ### Question 1: What are users searching for? **Ask:** "What do you want users to search for?" **Common answers and implications:** - **"Addresses"*.1.3kinstalls10Mapbox Search PatternsThe mapbox-search-patterns skill guides agents on selecting Mapbox search tools for geocoding, POI discovery, and reverse geocoding tasks. search_and_geocode_tool fits named places, brands, and street addresses such as Starbucks on 5th Avenue or 123 Main Street. category_search_tool handles generic plural categories like coffee shops, museums, or EV chargers. reverse_geocode_tool converts GPS coordinates into human-readable addresses. Parameter guidance prioritizes proximity biasing for nearby queries, bbox for hard regional bounds, and country filters when appropriate. A decision matrix maps user phrasing to the correct tool and warns against using category search for brand names or geocode search for generic plurals. Additional sections cover autocomplete behavior, language settings, limit tuning, and common failure patterns. Use when optimizing Mapbox search tool choice and parameters in agent workflows.1.2kinstalls11Mapbox Store Locator Patternsmapbox-store-locator-patterns is an official Mapbox agent skill from mapbox/mapbox-agent-skills that documents architecture for store locators and location finders. The readme defines six core components: a map with markers, GeoJSON location data, an interactive list, search and filter controls, user location with distance calculation, and optional directions. It includes a GeoJSON FeatureCollection example with Point geometry, store properties such as name, address, phone, category, and hours, plus guidance on wiring list-map interaction. Developers reach for mapbox-store-locator-patterns when shipping retail or service locator pages that must stay performant with real coordinates, filtering, and distance-aware UX on Mapbox.1.1kinstalls12Mapbox Ios Patternsmapbox-ios-patterns is a quick-reference skill from mapbox/mapbox-agent-skills for Mapbox Maps SDK v11 on iOS with Swift, SwiftUI, and UIKit. It documents Swift Package Manager installation from github.com/mapbox/mapbox-maps-ios.git at version 11.0.0+, Info.plist MBXAccessToken setup, and SwiftUI Map views with Viewport camera bindings. Developers reach for it when implementing interactive maps, style layers, or location features and need copy-paste-correct SDK v11 APIs instead of outdated Mapbox examples. The skill accelerates iOS map feature work by centralizing token config, imports, and viewport patterns in one agent-accessible reference.1kinstalls13Mapbox Mcp Devkit Patternsmapbox-mcp-devkit-patterns is a Mapbox agent skill that documents quick-reference patterns for the Mapbox MCP DevKit Server, an MCP server exposing Mapbox developer APIs to AI assistants. The hosted setup uses npx mcp-remote against https://mcp-devkit.mapbox.com with no local installation required, configured in Claude Desktop via claude_desktop_config.json. Capabilities include map style management, access token creation, resource validation, and inline documentation retrieval without leaving the editor. Developers reach for mapbox-mcp-devkit-patterns when building location-aware apps and want their Claude or Cursor agent to call Mapbox APIs directly through MCP instead of manual dashboard steps.1kinstalls14Mapbox Android Patternsmapbox-android-patterns from mapbox/mapbox-agent-skills documents official integration patterns for Mapbox Maps SDK v11 on Android using Kotlin, Jetpack Compose, and the traditional View system. The skill covers SDK installation and configuration, adding markers and annotations, showing user location with camera tracking, loading custom GeoJSON data, applying map styles, controlling camera movement, and handling featureset interactions—all aligned with official Mapbox documentation. Developers reach for mapbox-android-patterns when embedding interactive maps into Android apps instead of writing integration code from scattered docs. Patterns address common Android map tasks such as location permissions, annotation layers, and style switching without guessing API shapes. With 750 catalog installs, the skill suits mobile engineers building logistics, field, or consumer map features on Android—not iOS MapKit projects, web Mapbox GL JS-only work, or backend geospatial ETL pipelines without a mobile client.962installs15Mapbox Google Maps Migrationmapbox-google-maps-migration is an official Mapbox agent skill that walks developers through swapping Google Maps Platform APIs to Mapbox GL JS. The guide documents critical differences: Google uses {lat, lng} objects while Mapbox expects [lng, lat] arrays, Google favors imperative DOM markers while Mapbox uses declarative data-driven WebGL layers, and performance shifts from slowing around 500+ markers to handling 10,000+ points. Developers reach for this skill when refactoring map initialization, layers, sources, and event handlers without relearning Mapbox from generic docs. It is a migration quick reference with side-by-side API equivalents rather than a greenfield mapping tutorial.956installs16Mapbox Mcp Runtime Patternsmapbox-mcp-runtime-patterns is a Mapbox agent skill from mapbox/mapbox-agent-skills that serves as a quick reference for integrating the Mapbox MCP Server into AI applications for production use. The skill explains how the runtime MCP server exposes geospatial tools to agents through the Model Context Protocol and points to the mapbox/mcp-server repository for server setup. Developers reach for mapbox-mcp-runtime-patterns when agents need dependable geocoding, routing, map tile, or location-aware operations inside LLM-driven workflows rather than one-off REST calls. The readme organizes available tools by category with cost considerations, helping teams design agent tool access, error handling, and runtime deployment patterns. The skill targets integration engineers building location-aware agents, copilots, and automation that must call Mapbox capabilities through MCP instead of embedding maps-only frontend snippets.953installs17Mapbox Maplibre Migrationmapbox-maplibre-migration is a Mapbox agent skill that migrates MapLibre GL JS projects to Mapbox GL JS, noting the APIs are roughly 95% identical for straightforward conversion. It covers replacing tokens, style URLs, and configuration while unlocking official support, Mapbox Studio styles, Geocoding, Directions, Isochrone, Matrix APIs, Globe view, 3D terrain, and hosted tiles. The guide highlights a free tier of 50,000 map loads per month and enterprise compliance and analytics options. Frontend developers reach for it when self-hosted MapLibre stacks need premium global coverage, SLAs, or Mapbox platform services without rewriting the entire map UI.935installs18Mapbox Location Groundingmapbox-location-grounding is a skill from mapbox/mapbox-agent-skills that grounds AI responses in live Mapbox data by chaining MCP tools into structured, cited answers. It replaces hallucinated place names, POIs, ratings, and travel times with tool-backed results for queries like nearby search, neighborhood descriptions, and distance questions. Developers reach for it when building travel, logistics, or mapping assistants that must cite coordinates, routes, or POI metadata. The workflow emphasizes composing Mapbox MCP calls, validating results, and returning citations users can verify. Use it whenever location accuracy matters more than generic LLM recall.748installs19Mapbox Flutter PatternsTeaches Mapbox-recommended Flutter integration patterns for interactive maps, geolocation, layers, and camera behavior so mobile apps ship reliable mapping features without SDK anti-patterns.368installs