khawkins98-mapx-llm-skills

MapX LLM Skills

A Claude Code plugin that provides skills for developing with the MapX SDK, the JavaScript SDK for embedding maps from the MapX platform (UNEP/GRID-Geneva).

This is primarily built for Claude Code, but the skill content is plain markdown with code examples. If you use another AI coding tool that supports loading markdown context files (Cursor rules, Windsurf, Copilot instructions, etc.), you can point it at the files in skills/mapx-sdk-dev/ to get the same SDK reference material.

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

Auto-invoked when working on code that uses the MapX SDK. 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 (/mapx-embed-scaffold). 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

/mapx-embed-scaffold MX-2LD-FBB-58N-ROK-8RH

Installation

From GitHub (recommended)

Inside Claude Code, register this repo as a marketplace and install:

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

Or equivalently from the shell:

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

Local development

If you've cloned this repo locally, you can load it for a single session:

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

Or register it as a local marketplace so it persists:

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

Team/project configuration

To enable this plugin for all collaborators on a project, add both the marketplace and plugin to the project's .claude/settings.json and commit it:

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

Technical Details

MapX Platform