The create-map skill

The workflow, without the MCP server.

A skill is a folder of instructions an agent loads when a request matches. create-map triggers on "make a map of", "pin these places", "plot these addresses", "trip map" or "map of X by region" and teaches the agent how to use Polygrid Maps well. It does not trigger for charts, mind maps, diagrams or driving directions you only want to read.

What it does

  • Geocodes places by name instead of guessing coordinates.
  • Builds routes, categories with a filter legend, and popups with links and photos.
  • Makes choropleth data maps from real numbers per administrative area.
  • Creates the map over HTTP (a bundled script, or curl), returns the link and keeps the edit token to change the map later.

Install

Paste this into your agent

Install the Polygrid Maps create-map skill by running: npx -y skills add agilek/polygrid-maps --skill create-map Choose this agent when it asks where to install. Details: https://maps.polygrid.dev/docs/agents/skills. Then make a test map of three well-known places in my city and send me the link. Don't wait for a restart: the skill is already on disk, so read its skills/create-map/SKILL.md and run its scripts/publish.py directly. If this environment can't reach maps.polygrid.dev (sandbox, proxy or network allowlist), still make the map: publish.py then prints a publish link that opens the map in my own browser, ready to publish with one click. Send me that link. If you have no skill script, build that link yourself: https://maps.polygrid.dev/new#c= followed by the map request as JSON, base64url-encoded (details in https://maps.polygrid.dev/llms.txt). Then report back in two or three plain lines: that it is ready, the link, and one example of what I can ask next. Don't send me to add connectors, change network settings or ask an admin: a blocked network is handled by the publish link. Mention a restart only if it is really needed, as a short side note.

1. npx skills (any agent)

npx -y skills add agilek/polygrid-maps --skill create-map

The skills CLI asks which agents to install for (Claude Code, Codex, Cursor, Gemini CLI, OpenCode and more) and whether to install globally or per project.

2. As a plugin

The plugins for Claude Code, Codex, Cursor and Gemini CLI include this skill together with the MCP server.

3. As a zip (claude.ai, Claude Desktop)

Download create-map.zip and upload it under Settings → Capabilities → Skills. Allow network access to maps.polygrid.dev in code execution. Details on the Claude page.

4. Manual

Copy the create-map folder from the plugins repository into your agent's skills directory, for example ~/.claude/skills/.

Updates

The create-map skill keeps itself up to date: it checks the latest version once per conversation and updates itself when a newer one is out. To update by hand:

# Claude Code
claude plugin marketplace update polygrid
claude plugin update polygrid-maps@polygrid

# Codex
codex plugin marketplace upgrade polygrid
codex plugin add polygrid-maps@polygrid

# Gemini CLI
gemini extensions update polygrid-maps

# npx skills
npx -y skills update create-map

# any other copy, from the skill folder
python3 scripts/publish.py self-update

On claude.ai, download create-map.zip again and re-upload it. The latest version is at https://maps.polygrid.dev/v1/plugin; what changed is in the changelog.

Verify it works

Start a new session and ask the agent which skills it has: create-map should be listed. Then ask for a map (see Next steps). The agent needs network access to https://maps.polygrid.dev.

Next steps