mapx-llm-skills

MapX LLM Skills

Skills for developing with the MapX SDK, the JavaScript SDK for embedding maps from the MapX platform (UNEP/GRID-Geneva). Installable as a plugin in both Claude Code and GitHub Copilot CLI.

Background

I put these skills together while embedding MapX maps for disaster risk reduction work at UNDRR. The project started as a simple iframe embed and grew more involved as I explored the SDK.

The MapX SDK has documentation in the GitHub source, including a README and inline code comments. That said, there are some gaps — there's no standalone method catalog, no public API for view discovery, and some features are easier to find if you already know the resolver names. These skills try to fill in those gaps based on what I've learned from reading the source and testing.

A few examples of things I had to figure out by experimentation:

• view_add fails silently for views outside the current project (no error, no network request)
• toggle_draw_mode is referenced in older wiki examples but was removed from the SDK
• The postMessage bridge can't pass callbacks, so click interaction on custom layers needs a coordinate-matching workaround
• map_wait_idle() has to come before dashboard or filter operations, but this isn't always obvious from the docs

A note on accuracy: I'm relatively new to MapX, and the MapX developers at UNEP/GRID-Geneva will know the platform far better than I do. If you spot something wrong or outdated in these skills, please open an issue — corrections are very welcome.

As of early 2026, MapX doesn't have its own LLM skills or AI coding integrations. Mapbox has agent skills (MapX uses Mapbox GL JS under the hood), so there's precedent for this kind of thing in the geospatial space.

Skills

mapx-sdk-dev — SDK Development Reference

Both tools auto-detect this skill when working on MapX SDK code. You can also invoke it explicitly:

• Claude Code: /mapx-llm-skills:mapx-sdk-dev
• Copilot CLI: include /mapx-sdk-dev in your prompt

Provides:

• Method catalog (30+ resolver methods with signatures and return types)
• SDK initialization patterns (Manager constructor, singleton, ready event)
• View management (add/remove, GeoJSON views, Mapbox passthrough, layer ordering)
• Navigation and display (fly-to, projections, 3D modes, country/region codes)
• Filtering and data (numeric/text filters, transparency, data introspection, export)
• UI controls (language, themes, dashboards, map composer, share modal)
• Known limitations and workarounds (cross-project scope, no native events, click fallbacks)
• Troubleshooting guide organized by symptom

Example prompts:

• "Add a new MapX view to the map and show its legend"
• "Filter this vector layer to show only high-risk areas"
• "Set up transparency blending between two raster layers"
• "Why isn't my view_add call doing anything?"

mapx-embed-scaffold — Project Scaffolding

User-invoked. Generates a starter MapX embed project with:

• HTML + CSS sidebar/map layout
• Vite dev server and build configuration
• Modular SDK wrapper files (client, views, filters, map-control, ui)
• State management (openViews tracking)
• View toggle buttons with active state

Invoke explicitly:

• Claude Code: /mapx-llm-skills:mapx-embed-scaffold MX-2LD-FBB-58N-ROK-8RH
• Copilot CLI: include /mapx-embed-scaffold MX-2LD-FBB-58N-ROK-8RH in your prompt

Installation

Before installing, see Limitations and workarounds for known SDK quirks (cross-project view scope, missing native events, raster query limits, REST/MeiliSearch auth).

Claude Code

From GitHub (recommended):

/plugin marketplace add khawkins98/mapx-llm-skills
/plugin install mapx-llm-skills@khawkins98-mapx-llm-skills

Or from the shell:

claude plugin install mapx-llm-skills@khawkins98-mapx-llm-skills

Local clone:

claude --plugin-dir /path/to/mapx-llm-skills

Team/project configuration — commit to .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "khawkins98-mapx-llm-skills": {
      "source": {
        "source": "github",
        "repo": "khawkins98/mapx-llm-skills"
      }
    }
  },
  "enabledPlugins": {
    "mapx-llm-skills@khawkins98-mapx-llm-skills": true
  }
}

GitHub Copilot CLI

Install from a local clone:

copilot plugin install /path/to/mapx-llm-skills

Install directly from GitHub (no local clone needed):

copilot plugin install khawkins98/mapx-llm-skills

Verify the install:

copilot plugin list

Or inside an interactive session: