mapsgl-android
This skill should be used when working with the Xweather MapsGL Android SDK (mapsgl-android-sdk / com.xweather.mapsgl) - setting up MapboxMapController, adding or removing weather layers via LayerCode or WeatherService configs, styling with StyleValue and Expression, custom sources and layers, legends, data inspector presentations, timeline animation, layer masks, or integrating the AAR/JitPack dependency into an Android app. Use it whenever a task mentions MapsGL Android, MapboxMapController, addWeatherLayer, LayerCode, WeatherService, XweatherAccount, or weather overlays on Mapbox Maps SDK for Android. Also covers MapsGL session-based usage/cost (shared with the JS SDK) and common Android gotchas (Mercator, OpenGL ES 3.0, minSdk 28, Mapbox peer dependency). Documents the MapsGL Android 1.6.1 release - every API here is in that published build, with no unreleased or development-branch surface. When docs and SDK disagree, prefer the SDK (source / KDoc / demos) over xweather.com documentation.
Install
With your agent
Install OMGSkills skill "vaisala-xweather/xweather-agent-skills:plugins/xweather/skills/mapsgl-android" into this agent's normal skills directory: call the OMGSkills MCP get_install_plan tool for your agent and run the script it returns (it installs only the pinned commit and verifies SKILL.md), and stop if MCP or the pin is unavailable. Do not overwrite or change existing skills without asking me.
Manual command
git clone https://github.com/vaisala-xweather/xweather-agent-skills /tmp/xweather-agent-skills && ln -s /tmp/xweather-agent-skills/plugins/xweather/skills/mapsgl-android ~/.claude/skills/mapsgl-androidFrom README
MapsGL Android MapsGL Android renders weather and custom map data on top of the Mapbox Maps SDK for Android (encoded grids via OpenGL ES custom layers; many vector weather layers via Mapbox style layers). Requires an Xweather account (Weather API + Maps) and Mapbox access / downloads tokens. Source of truth (read this first) When answering or writing code, resolve conflicts in this order: The MapsGL Android SDK - public Kotlin APIs in mapsglmaps / published AAR, in-repo demos under app/, and generated KDoc This skill (kept to match the SDK) https://www.xweather.com/docs/mapsgl-android-sdk/ - useful for tutorials and recipes, but often lagging (deprecated ctors, wrong removeWeatherLayer args, missing Mapbox peer dep, "coming soon" for shipped features, invented overload shapes) Prefer the SDK to the docs. If a docs snippet disagrees with a real method signature, package, or demo in the SDK, follow the SDK and say so.
More from this repo
mapsgl
This skill should be used when working with the Xweather MapsGL JavaScript SDK for the web (@xweather/mapsgl) — setting...
mapsgl-apple
This skill should be used when working with the Xweather MapsGL SDK for Apple platforms (the MapsGL...
raster-maps
This skill should be used to build Xweather Raster Maps image URLs (maps.api.xweather.com) — either static map images...