mapbox-style-quality

What problem does it solve?

Mapbox style quality is essential for reliable maps and consistent user experiences. This Skill provides structured guidance to validate style syntax, ensure accessibility, and optimize performance prior to production. It helps teams catch issues early and maintain quality across web, iOS, and Android platforms.

Core Features & Use Cases

• Validation rules and best practices for Mapbox GL styles, ensuring valid sources, layers, and references.
• Accessibility checks (WCAG compliance) to guarantee readable text, proper contrast, and usable UI.
• Performance optimization workflows to reduce file size, improve render times, and enable smooth interactions.
• Version comparison and QA processes to track changes and ensure consistent deployments across environments.
• Use Case: A map team preps a production-ready style, runs validation and accessibility checks, and tunes performance before release.

Quick Start

• Start by auditing your current style against the validation rules and accessibility checks.
• Then apply recommended optimization steps (remove unused sources, simplify expressions, and prune empty layers).
• Finally confirm changes with a style comparison and deploy to production.