From mapx-llm-skills
Reference skill for developing with the MapX SDK (UNEP/GRID-Geneva). Auto-invoked when creating or modifying code that embeds MapX maps, manages views, queries geospatial data, or controls the map via the SDK's postMessage bridge. Covers the full SDK resolver API, the Mapbox GL JS passthrough pattern, GeoJSON overlays, filtering, data export, and known limitations.
How this skill is triggered — by the user, by Claude, or both
Slash command
/mapx-llm-skills:mapx-sdk-devThis skill is limited to the following tools:
The summary Claude sees in its skill listing — used to decide when to auto-load this skill
This skill is a reference for building applications that embed MapX maps
This skill is a reference for building applications that embed MapX maps via the JavaScript SDK.
This skill was developed and tested against the deployed MapX SDK at
app.mapx.org/sdk/mxsdk.umd.js (embedded version string 1.13.19)
during March 2026. The SDK does not pin versions in its UMD URL, so
the deployed version may change without notice.
The GitHub source on the main branch (@fxi/mxsdk 1.9.40-alpha.1)
does not match the deployed build. Where method signatures or behavior
differ between the source and what was observed at runtime, this skill
documents the observed behavior and notes the discrepancy.
If a method documented here doesn't work as described, the deployed SDK
may have changed. Check the SDK source
(note: default branch is main, not master).
MapX is an open-source geospatial platform managed by UNEP/GRID-Geneva for sustainable development and environmental monitoring. The SDK allows embedding MapX maps in external websites with programmatic control over views, layers, navigation, and data.
https://app.mapx.org/sdk/mxsdk.umd.jssearch.mapx.org (MeiliSearch, requires API key -- see limitations §12)The SDK uses a postMessage bridge: the parent page loads mxsdk.umd.js,
creates a Manager that embeds an iframe, and all communication goes through
window.postMessage as serialized JSON. mapx.ask("resolver_name", {params})
returns Promises. See initialization.md for full details.
Critical constraint: You cannot pass functions, callbacks, DOM elements, or any non-serializable value through the bridge. See limitations-and-workarounds.md for workarounds.
ready event before making SDK callsmap_wait_idle() before dashboard/filter/data operationsProvides behavioral guidelines to reduce common LLM coding mistakes, focusing on simplicity, surgical changes, assumption surfacing, and verifiable success criteria.
Searches, retrieves, and installs Agent Skills from prompts.chat registry using MCP tools like search_skills and get_skill. Activates for finding skills, browsing catalogs, or extending Claude.
Creates, edits, and optimizes skills for Claude Code, including drafting, evaluating with test prompts, iterating on performance, and improving skill descriptions for better triggering accuracy.
npx claudepluginhub khawkins98/mapx-llm-skills --plugin mapx-llm-skills