Agent skill

Maplibre Skill Authoring

by maplibre in maplibre/maplibre-agent-skills

How to turn a working session into a MapLibre agent skill — you researched something MapLibre's docs did not cover, got it wrong before you got it right, shipped it, and the session is about to end.

Custom licenceAuto-check passedAgent Workflows

Install Maplibre Skill Authoring

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

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

GitHub CLI
$ gh skill install maplibre/maplibre-agent-skills maplibre-skill-authoring --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-skill-authoring .claude/skills/maplibre-skill-authoring && 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-skill-authoring
GitHub stars
151
Token cost
~1.8k tokens
SKILL.md length
994 words
Files
1
Skills in repo
10
Repo updated
First seen
Licence
Custom licence

At a glance

How to turn a working session into a MapLibre agent skill — you researched something MapLibre's docs did not cover, got it wrong before you got it right, shipped it, and the session is about to end.

  • Works in 4 steps: The wrong first answer, verbatim. What… → The primary sources you actually opened.… → The correct claim, in one or two… → …
  • Tasks that involve Skill authoring
  • SKILL.md covers When to Use This Skill, Capture first, decide later, Separate the claim from the… and Size it before you write it, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Maplibre Skill Authoring is an agent skill from maplibre/maplibre-agent-skills. How to turn a working session into a MapLibre agent skill — you researched something MapLibre's docs did not cover, got it wrong before you got it right, shipped it, and the session is about to end. Covers what to capture while the context is still live, how to separate the durable claim from the project it came from, and where to hand it off. Use at the end of a MapLibre task that took real research, or when asked to capture one as a skill.

Its SKILL.md is about 1.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 Agent Workflows, covering Skill authoring. 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

  • Tasks that involve Skill authoring

Example prompts

  • “/maplibre-skill-authoring”

Workflow steps

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

  1. The wrong first answer, verbatim. What you asserted, wrote, or would have written before you checked. This is the baseline hypothesis, and…
  2. The primary sources you actually opened. URLs, not recollections: the style spec page, the GL JS docs page, the PR or issue, the CHANGELOG…
  3. The correct claim, in one or two sentences. Written as a rule, not as a narrative of what you did.
  4. Versions and the minimal reproduction. Which MapLibre version, which SDK (GL JS and Native diverge), and the smallest style or code that…

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.

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

  • Network

    Links to these hosts (documentation or services it may open):

    • github.com
    • agentskills.io

    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 Skill Authoring loads about 1.8k tokens when it runs. Until then it costs about 118 tokens; SKILL.md has 994 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~118
When it runs · the whole SKILL.md, loaded when a task matches
~1.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 994 words (~1,830 tokens).

“The most valuable input to maplibre-agent-skills is a session where an agent got a MapLibre answer wrong, went and found the right one, and shipped working code. That session holds something no later reconstruction can recover: the wrong answer that…”

— opening of SKILL.md by maplibre, Custom licence
name
maplibre-skill-authoring
status
process

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/maplibre-skill-authoring of maplibre/maplibre-agent-skills.

Open the folder on GitHubat commit 99f8774

Compare with similar skills

Maplibre Skill Authoring 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 Skill Authoring compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Maplibre Skill Authoring this skillmaplibre/maplibre-agent-skills151—~1.8kAutomated safety check: PassCustom licence
Skill CreatorAzure/azqr79689 repos~8.2kAutomated safety check: PassApache-2.0
Claude Code Skill Developer Guidediet103/claude-code-infrastructure-showcase10k11 repos~3.5kAutomated safety check: PassMIT
Darwin Skill Optimizeralchaincyf/darwin-skill6.2k1 repos~4.7kAutomated safety check: PassMIT
Claude Code Command Developmentanthropics/claude-plugins-official38k10 repos~4.8kAutomated safety check: PassApache-2.0
Claude Code Plugin Structureanthropics/claude-plugins-official38k10 repos~3.4kAutomated safety check: PassApache-2.0

Similar skills

  • Skill Creator

    Azure/azqr

    Official

    Create new skills, modify and improve existing skills, and measure skill performance.

    796 GitHub starsUsed in 89 repos~8.2k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Skill Developer Guide

    diet103/claude-code-infrastructure-showcase

    A guide to creating and managing Claude Code skills with auto-activation: skill-rules.json triggers, hooks, enforcement levels, YAML frontmatter and progressive disclosure.

    10k GitHub starsUsed in 11 repos~3.5k tokens
    Agent WorkflowsAuto-check passed
  • Darwin Skill Optimizer

    alchaincyf/darwin-skill

    Scores SKILL.md files on a nine-dimension rubric, then improves them in a keep-or-revert loop with independent judge agents, test prompts, git history and human checkpoints.

    6.2k GitHub starsUsed in 1 repo~4.7k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Command Development

    anthropics/claude-plugins-official

    Official

    Explains how to write Claude Code slash commands: Markdown files with YAML frontmatter, arguments, file references, bash context and interactive prompts.

    38k GitHub starsUsed in 10 repos~4.8k tokens
    Agent WorkflowsAuto-check passed
  • Claude Code Plugin Structure

    anthropics/claude-plugins-official

    Official

    Explains the directory layout, plugin.json manifest and component organization of a Claude Code plugin, including auto-discovery and portable paths.

    38k GitHub starsUsed in 10 repos~3.4k tokens
    Agent WorkflowsAuto-check passed
  • Skill Release Gate

    rohitg00/ai-engineering-from-scratch

    Evaluates an Agent Skill bundle before release for structure, trigger quality, artifact improvement, script correctness, safety, installed-tree integrity and host portability.

    67k GitHub stars~1k tokensUpdated today
    Agent WorkflowsAuto-check passed

More from maplibre/maplibre-agent-skills

All 10 skills in this repo
  • Maplibre Cartography

    maplibre/maplibre-agent-skills

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

    151 GitHub stars~4.8k tokensUpdated yesterday
    Auto-check passed
  • 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

Categories

Questions about Maplibre Skill Authoring

What does Maplibre Skill Authoring do?

How to turn a working session into a MapLibre agent skill — you researched something MapLibre's docs did not cover, got it wrong before you got it right, shipped it, and the session is about to end. Maplibre Skill Authoring is an agent skill from maplibre/maplibre-agent-skills. How to turn a working session into a MapLibre agent skill — you researched something MapLibre's docs did not cover, got it wrong before you got it right, shipped it, and the session is about to end.

When should I use Maplibre Skill Authoring?

Maplibre Skill Authoring fits situations like: tasks that involve Skill authoring.

How do I install Maplibre Skill Authoring in Claude Code?

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

How do I install Maplibre Skill Authoring in Codex?

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

Can I use Maplibre Skill Authoring 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-skill-authoring -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-skill-authoring, .gemini/skills/maplibre-skill-authoring, .github/skills/maplibre-skill-authoring and .opencode/skills/maplibre-skill-authoring in your project.

What does Maplibre Skill Authoring need to run?

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

Does Maplibre Skill Authoring access the network?

SKILL.md names 2 domains. As links in the text: github.com and agentskills.io. This is read from the text; nothing was executed.

Is Maplibre Skill Authoring 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 Skill Authoring use?

Maplibre Skill Authoring 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 Skill Authoring use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Skill Authoring?

Skills that share tags, products or a category with Maplibre Skill Authoring: Skill Creator (Azure/azqr, 796 stars), Claude Code Skill Developer Guide (diet103/claude-code-infrastructure-showcase, 10k stars), Darwin Skill Optimizer (alchaincyf/darwin-skill, 6.2k stars) and Claude Code Command Development (anthropics/claude-plugins-official, 38k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Maplibre Skill Authoring?

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.