Agent skill

Maplibre Cartography

by maplibre in maplibre/maplibre-agent-skills

Cartographic principles for MapLibre GL JS — label and symbol legibility on imagery vs.

Custom licenceAuto-check passedFrontend & Design

Install Maplibre Cartography

skills CLI
$ npx skills add maplibre/maplibre-agent-skills --skill maplibre-cartography -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install maplibre/maplibre-agent-skills maplibre-cartography --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/maplibre/maplibre-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/maplibre-cartography .claude/skills/maplibre-cartography && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
maplibre-cartography
GitHub stars
151
Token cost
~4.8k tokens
SKILL.md length
2,415 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

Cartographic principles for MapLibre GL JS — label and symbol legibility on imagery vs.

  • Works in 2 steps: Confirm glyphs load. Probe the glyphs… → Confirm the sprite carries the shield…
  • Roads readable on satellite/aerial imagery
  • SKILL.md covers When to Use This Skill, Basemap Type Determines Label…, Point Symbols and Icons on… and Visual Hierarchy, plus 6 more sections
  • Reaches demotiles.maplibre.org

What it does

Maplibre Cartography is an agent skill from maplibre/maplibre-agent-skills. Cartographic principles for MapLibre GL JS — label and symbol legibility on imagery vs. vector basemaps, figure-ground for point icons, styling vector roads over aerial imagery, visual hierarchy, sprites and route shields, layer ordering for data injection, and accessibility. Use when styling a map, choosing text or symbol colors, making markers or roads readable on satellite/aerial imagery, setting up icons, debugging shields, or ordering layers correctly.

Its SKILL.md is about 4.8k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Accessibility. The repository describes itself as: Community-maintained agent skills for MapLibre GL JS — helping AI coding assistants write better mapping code.

When your agent uses it

  • Roads readable on satellite/aerial imagery
  • Setting up icons
  • Debugging shields
  • Ordering layers correctly

Example prompts

  • “/maplibre-cartography”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. Confirm glyphs load. Probe the glyphs server for the exact text-font names and expect HTTP 200. If they 200, the font is not the problem.
  2. Confirm the sprite carries the shield images. OpenMapTiles and OSM Liberty shield style layers use icon-image: "{network}_{ref_length}"…

What it can do on your machine

Read from SKILL.md and the folder at commit 99f8774. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • demotiles.maplibre.org

    Also links to:

    • github.com
    • maplibre.org
    • webaim.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Maplibre Cartography loads about 4.8k tokens when it runs. Until then it costs about 121 tokens; SKILL.md has 2,415 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~121
When it runs · the whole SKILL.md, loaded when a task matches
~4.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 2,415 words (~4,773 tokens).

“MapLibre renders exactly what you describe in your style. This skill covers how to describe it well: choosing label colors for readability on any basemap, building a coherent visual hierarchy, sourcing and self-hosting icons, and ordering style layers correctly. For…”

— opening of SKILL.md by maplibre, Custom licence
name
maplibre-cartography
status
verified

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/maplibre-cartography of maplibre/maplibre-agent-skills.

Open the folder on GitHubat commit 99f8774

Compare with similar skills

Maplibre Cartography next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Maplibre Cartography compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maplibre Cartography this skillmaplibre/maplibre-agent-skills151—~4.8kAutomated safety check: PassCustom licence
Ant Designkqcoxn/MaaPipelineEditor4081 repos~1.1kAutomated safety check: PassMIT
Scout UI Testingelastic/kibana21k—~3.1kAutomated safety check: PassCustom licence
Gui Debugnatsukium/dotfiles106—~909Automated safety check: PassCC0-1.0
Best Practicestech-leads-club/agent-skills7k—~3.2kAutomated safety check: PassMIT
Md Reviewalirezarezvani/claude-skills28k—~1.6kAutomated safety check: PassMIT

Similar skills

  • Ant Design

    kqcoxn/MaaPipelineEditor

    Decision guide for antd 6.x, Ant Design Pro 5/ProComponents, Ant Design X v2, and the offline @ant-design/cli.

    408 GitHub starsUsed in 1 repo~1.1k tokens
    Frontend & DesignAuto-check passed
  • Scout UI Testing

    elastic/kibana

    Official

    A skill your agent uses when creating, updating, debugging, or reviewing Scout UI tests in Kibana (Playwright + Scout fixtures), including page objects, browser authentication, parallel UI tests…

    21k GitHub stars~3.1k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Gui Debug

    natsukium/dotfiles

    Verify a rendering or window-chrome change in any macOS GUI app unattended — find its CGWindowID via JXA, capture that window alone (with per-pixel alpha) using screencapture -l, and read exact RGBA…

    106 GitHub stars~909 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Best Practices

    tech-leads-club/agent-skills

    Apply modern web development best practices for security, compatibility, and code quality.

    7k GitHub stars~3.2k tokensUpdated 2 days ago
    Frontend & DesignAuto-check passed
  • Md Review

    alirezarezvani/claude-skills

    Converts a markdown PR writeup or code review (one with diff fenced blocks and severity-tagged [!BLOCKER]/[!MAJOR]/[!MINOR]/[!NIT] callouts) into a single-file 2-column HTML review — unified-diff on…

    28k GitHub stars~1.6k tokensUpdated 1 mo ago
    Frontend & DesignAuto-check passed
  • Constraint Driven Development

    sickn33/agentic-awesome-skills

    Write the project quality bar as enforced CONSTRAINTS.md so agents stop quietly lowering it: coverage, performance, accessibility thresholds watched on every diff.

    47k GitHub starsUsed in 1 repo~5.3k tokens
    Frontend & DesignAuto-check passed

More from maplibre/maplibre-agent-skills

All 10 skills in this repo
  • Maplibre Fonts Glyphs

    maplibre/maplibre-agent-skills

    Configuring fonts and glyphs for MapLibre GL JS and MapLibre Native — the style's glyphs URL, self-hosting or generating font PBFs, the GL JS local-font fallback (omitted glyphs or a failed glyph…

    151 GitHub stars~2.6k tokensUpdated yesterday
    Auto-check passed
  • Maplibre Mapbox Migration

    maplibre/maplibre-agent-skills

    Migrating from Mapbox GL JS to MapLibre GL JS — package and import changes, removing the access token, choosing tile sources, plugin equivalents, and what you gain or give up.

    151 GitHub stars~4.7k tokensUpdated yesterday
    Auto-check passed
  • Maplibre Pmtiles Patterns

    maplibre/maplibre-agent-skills

    Serverless vector and raster tiles with PMTiles for MapLibre GL JS — single-file format, HTTP range requests, hosting on S3/R2/GitHub Pages, generating with Planetiler or tippecanoe, and the pmtiles…

    151 GitHub stars~4.6k tokensUpdated yesterday
    Auto-check passed
  • Maplibre Running Evals

    maplibre/maplibre-agent-skills

    The step-by-step procedure for running this repo's Promptfoo evals with a generator and a judge over provider APIs.

    151 GitHub stars~3.3k tokensUpdated yesterday
    Auto-check passed
  • Maplibre Source Wiring

    maplibre/maplibre-agent-skills

    Getting a MapLibre GL JS source to actually render — TileJSON url versus hand-wired tiles templates, matching source-layer names to the tile schema, layer order and inserting below labels, promoteId…

    151 GitHub stars~3.8k tokensUpdated yesterday
    Auto-check passed
  • Maplibre Terrain Rendering

    maplibre/maplibre-agent-skills

    Drawing elevation in MapLibre GL JS once a raster-dem source works — hillshade and hillshade-method, the color-relief layer and the ["elevation"] expression, runtime contours with maplibre-contour…

    151 GitHub stars~2.7k tokensUpdated yesterday
    Auto-check passed

Questions about Maplibre Cartography

What does Maplibre Cartography do?

Cartographic principles for MapLibre GL JS — label and symbol legibility on imagery vs. Maplibre Cartography is an agent skill from maplibre/maplibre-agent-skills. Cartographic principles for MapLibre GL JS — label and symbol legibility on imagery vs.

When should I use Maplibre Cartography?

Maplibre Cartography fits situations like: roads readable on satellite/aerial imagery; setting up icons; debugging shields; ordering layers correctly.

How do I install Maplibre Cartography in Claude Code?

Run `npx skills add maplibre/maplibre-agent-skills --skill maplibre-cartography -a claude-code`. Or copy the skill folder (skills/maplibre-cartography in maplibre/maplibre-agent-skills) into .claude/skills/maplibre-cartography in your project. Claude Code loads it when a task matches its description.

How do I install Maplibre Cartography in Codex?

Run `npx skills add maplibre/maplibre-agent-skills --skill maplibre-cartography -a codex`. Or copy the skill folder (skills/maplibre-cartography in maplibre/maplibre-agent-skills) into .agents/skills/maplibre-cartography in your project. Codex loads it when a task matches its description.

Can I use Maplibre Cartography in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add maplibre/maplibre-agent-skills --skill maplibre-cartography -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/maplibre-cartography, .gemini/skills/maplibre-cartography, .github/skills/maplibre-cartography and .opencode/skills/maplibre-cartography in your project.

What does Maplibre Cartography need to run?

SKILL.md names no scripts, command-line tools or credentials: Maplibre Cartography is instructions for the agent only.

Does Maplibre Cartography access the network?

SKILL.md names 4 domains. In commands or code: demotiles.maplibre.org; the agent is likely to contact it when it follows the instructions. As links in the text: github.com, maplibre.org and webaim.org. This is read from the text; nothing was executed.

Is Maplibre Cartography safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Maplibre Cartography use?

Maplibre Cartography has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.

How many tokens does Maplibre Cartography use?

About 4.8k tokens (SKILL.md is roughly 19k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Maplibre Cartography?

Skills that share tags, products or a category with Maplibre Cartography: Ant Design (kqcoxn/MaaPipelineEditor, 408 stars), Scout UI Testing (elastic/kibana, 21k stars), Gui Debug (natsukium/dotfiles, 106 stars) and Best Practices (tech-leads-club/agent-skills, 7k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maplibre Cartography?

maplibre (a GitHub organization) maintains it in maplibre/maplibre-agent-skills, which has 151 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 2026.

Source: maplibre/maplibre-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.