Mapbox Style Quality

This is your pre-deployment checklist in skill form. It validates Mapbox style expressions before runtime errors bite you, checks WCAG color contrast ratios for text labels (4.5:1 for AA, 7:1 for AAA), and optimizes styles by removing empty layers and simplifying redundant boolean logic. The workflow is straightforward: validate your GeoJSON sources, check expressions as you write them, verify text readability, compare versions before committing, then optimize before shipping. It's honestly just good hygiene for production maps, the kind of stuff you skip when prototyping but absolutely need before real users see your work. The comparison tool is especially handy when you inherit someone else's style and need to understand what actually changed between versions.

skills.sh installs: 2K
GitHub stars: 86
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add mapbox/mapbox-agent-skills --skill mapbox-style-quality --agent claude-code

Installs into .claude/skills of the current project.

Files

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:

Validate all expressions - Catch syntax errors before runtime
Check color contrast - Ensure text is readable (WCAG compliance)
Validate GeoJSON sources - Ensure data integrity
Optimize style - Reduce file size and improve performance
Compare versions - Understand what changed
Remove empty layers - Delete layers with no visible paint properties as a final cleanup step
Simplify redundant boolean expressions - Clean up filters with unnecessary boolean logic (e.g., ["all", expr] → expr, ["any", false, expr] → expr)