Add mapbox-navigation-patterns skill

README.md

@@ -530,6 +530,51 @@ Comprehensive guide covering marker display strategies, filtering, distance calc
 
 ---
 
+### 🧭 mapbox-navigation-patterns
+
+**Quick reference for implementing navigation and routing with Mapbox Directions API and Navigation SDKs.**
+
+Covers web routing, turn-by-turn navigation, multi-stop routes, optimization, traffic-aware routing, and voice guidance across Web, iOS, and Android platforms.
+
+**Use when:**
+
+- Implementing routing and directions in applications
+- Adding turn-by-turn navigation (iOS/Android)
+- Building delivery route optimization
+- Showing traffic-aware routes
+- Need voice guidance for navigation
+- Calculating ETAs or route alternatives
+
+**Key topics:**
+
+- Directions API for web (basic routes, alternatives, multi-stop, optimization)
+- Navigation SDK for iOS (NavigationViewController, voice guidance, custom UI)
+- Navigation SDK for Android (NavigationView, custom UI, route progress)
+- Traffic-aware routing with congestion data
+- Route caching and performance optimization
+- Error handling and best practices
+
+**Covers all platforms:**
+
+- Web (Directions API with Mapbox GL JS)
+- iOS (Navigation SDK for iOS with Swift)
+- Android (Navigation SDK for Android with Kotlin)
+
+**Common patterns:**
+
+- Basic route display on map
+- Alternative routes comparison
+- Multi-stop waypoint routing (up to 25 waypoints)
+- Route optimization for deliveries
+- Turn-by-turn instruction display
+- Traffic congestion visualization
+- Voice-guided navigation
+- Ride-sharing ETA calculations
+
+[View skill →](./skills/mapbox-navigation-patterns/SKILL.md)
+
+---
+
 ### 🔄 mapbox-google-maps-migration
 
 **Comprehensive migration guide for developers moving from Google Maps Platform to Mapbox GL JS.**

skills/README.md

@@ -11,6 +11,7 @@ This directory contains Agent Skills that provide domain expertise for building
 | [mapbox-maplibre-migration](./mapbox-maplibre-migration/)                   | Migration guide between Mapbox GL JS and MapLibre GL JS in both directions                                                       |
 | [mapbox-mcp-devkit-patterns](./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](./mapbox-mcp-runtime-patterns/)               | Integration patterns for Mapbox MCP Server in AI applications with pydantic-ai, mastra, LangChain, and custom agents             |
+| [mapbox-navigation-patterns](./mapbox-navigation-patterns/)                 | Navigation and routing patterns for Directions API and Navigation SDKs                                                           |
 | [mapbox-search-integration](./mapbox-search-integration/)                   | Complete workflow for implementing Mapbox search with discovery questions and best practices                                     |
 | [mapbox-search-patterns](./mapbox-search-patterns/)                         | Choosing the right search tool and parameters for geocoding and POI search                                                       |
 | [mapbox-web-performance-patterns](./mapbox-web-performance-patterns/)       | Performance optimization for Mapbox GL JS (initialization, markers, data loading, memory)                                        |