К основному содержанию
скилл CX Codex

maplibre-skill-authoring — скилл для Claude Code: создание и установка

Скилл maplibre-skill-authoring помогает превратить исследовательскую сессию по MapLibre в материал для нового или существующего скилла. Запускайте его, пока контекст задачи ещё открыт.

MIT 229 установок ★ 164 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add maplibre/maplibre-agent-skills --skill maplibre-skill-authoring -a claude-code
Открыть на GitHub

Что делает maplibre-skill-authoring

Скилл подсказывает, что сохранить после сложной задачи по MapLibre: первоначальный неверный ответ, открытые первоисточники, верное правило, версии и минимальный пример. Первоначальную ошибку важно записать сразу: после нахождения решения её уже трудно восстановить.

Затем он помогает отделить общее правило от особенностей проекта, подготовить проверку и передать предложение на рассмотрение. Рекомендации охватывают выбор места для изменения и честное описание того, что проверено. Для установки в Claude Code нужна команда npx skills add maplibre/maplibre-agent-skills --skill maplibre-skill-authoring -a claude-code; файл устанавливается по пути ~/.claude/skills/maplibre-skill-authoring/SKILL.md.

Какие задачи решает

  • зафиксировать неверную первую гипотезу по MapLibre
  • сохранить первоисточники и минимальный пример поведения
  • отделить общее правило от особенностей кодовой базы
  • подготовить проверку утверждения и передать её на рассмотрение

Примеры запросов агенту

  • Собери из этой сессии по MapLibre материал для скилла: сохрани первую неверную гипотезу и источники.
  • Выдели правило, которое применимо вне этого проекта, и подготовь проверку на основе нашей сессии.

Как установить maplibre-skill-authoring

1Через Skills CLI (Vercel)

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

2Вручную: положить файлы

~/.claude/skills/maplibre-skill-authoring/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/maplibre-skill-authoring/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о maplibre-skill-authoring

Как установить maplibre-skill-authoring в Claude Code?

Выполните npx skills add maplibre/maplibre-agent-skills --skill maplibre-skill-authoring -a claude-code. Скилл появится по пути ~/.claude/skills/maplibre-skill-authoring/SKILL.md.

Что делает maplibre-skill-authoring?

Помогает собрать результаты исследовательской сессии по MapLibre и оформить их как предложение для скилла. Также подсказывает, как отделить общее правило от деталей проекта.

Что сохранить до завершения сессии по MapLibre?

Зафиксируйте первую неверную гипотезу, первоисточники, верное правило, версии и минимальный пример. Первую гипотезу нужно записать, пока контекст ещё открыт.

Исходный текст

SKILL.md · MIT
---
name: maplibre-skill-authoring
description: 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.
metadata:
  status: process
---

# Authoring a Skill From a Session

The most valuable input to [maplibre-agent-skills](https://github.com/maplibre/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 came first.** It is the evidence that a skill is warranted at all, and it exists only until the context ends.

This skill is about that harvest. It does not restate how to contribute — [`AGENTS.md`](https://github.com/maplibre/maplibre-agent-skills/blob/main/AGENTS.md) has the agent-specific rules and [`CONTRIBUTING.md`](https://github.com/maplibre/maplibre-agent-skills/blob/main/CONTRIBUTING.md) has the lanes and the four-step order for writing a new skill. Read those for the handoff; read this before the session ends, because after that most of what follows is unrecoverable.

## When to Use This Skill

- A MapLibre task just took real research: docs, source, a CHANGELOG, an issue thread
- The first approach was wrong, or right for Mapbox GL JS and wrong for MapLibre
- A version boundary, gotcha, or failure mode turned up that the docs do not state plainly
- Someone asks to capture the session as a skill

## Capture first, decide later

Do this while the session is still open. Four things, in a scratch file:

1. **The wrong first answer, verbatim.** What you asserted, wrote, or would have written before you checked. This is the baseline hypothesis, and it is the only artifact here that cannot be reconstructed afterward — once the correct answer is in context, the model will not produce the wrong one again on request. A skill earns its place only where a model fails without it, so this is what makes the eval writable.
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 entry. A citation reconstructed later from memory is a guess wearing a link.
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 shows the behavior.

## Separate the claim from the project

Everything above is entangled with the codebase it came from. The test for each line: **would this be true in someone else's project?**

- Cut project names, file paths, internal architecture, and business logic. If a code sample only makes sense with your app around it, rewrite it against a bare map.
- Keep the version boundary. "Broken before X, works after" is judgment; "it works" is not.
- Keep the reason the wrong answer was plausible. That is what makes the skill catch the next agent, and it is usually a Mapbox GL JS habit or a stale training-data assumption.
- Nothing private ships. Anonymize the report; the failure travels, your employer's code does not.

## Size it before you write it

One session's failure buys **one test and one section** — usually an addition to a skill that already exists. Check [Available Skills](https://github.com/maplibre/maplibre-agent-skills#available-skills) and the [open issues](https://github.com/maplibre/maplibre-agent-skills/issues) before assuming you have a new one.

A new skill is warranted only when the claim has no home: not a subtopic of a shipped skill, and not one an existing skill should own. Prefer adding a section, then a pointer between skills, then a new skill last.

## Write the eval from the session, not from the draft

Turn the captured artifacts into an eval before writing content, and write it from what happened rather than from what you intend to say:

- The prompt is **the question the session actually started with**, stripped of the project.
- The rubric encodes **the correct claim** (artifact 3), phrased so it would grade a stranger's answer — not so it matches your draft's wording.
- The `icontains` tripwire is **the name the wrong answer invented** (artifact 1), asserted as `not-icontains`, plus the real name asserted as `icontains`. A session that hallucinated an API name hands you the sharpest tripwire you will ever write.

Mechanics, provider setup, and the baseline run are in [`evals/README.md`](https://github.com/maplibre/maplibre-agent-skills/blob/main/evals/README.md).

## Hand it off honestly

You are drafting a proposal, not a verified skill, and saying so is part of the handoff. State which claims you verified against a primary source and which you could not. If you cannot run the eval — no API keys, or you are working outside a clone of the repo — say that plainly rather than omitting it, and leave the pull request and its description to the human who will answer for them in review.

A failure report carrying artifacts 1, 2, and 4 is a complete contribution on its own. It is worth more than a draft skill with no evidence behind it.

## Do not

- **Don't paste the transcript.** A session is the source material, not the deliverable.
- **Don't cite a source you did not open.** Reconstructed references are the most common way a confidently wrong claim gets through review.
- **Don't report an eval result you did not run**, and don't invent the API keys to run one.
- **Don't promote a project quirk to a skill.** If the fix depended on your build setup, it is not MapLibre judgment.
- **Don't skip the baseline because the answer feels obviously missing.** The model may already get it right, and that finding is a result worth reporting, not a dead end.

## Related Skills

- [**maplibre-mapbox-migration**](../maplibre-mapbox-migration/SKILL.md) — the frequent source of a plausible wrong first answer, where a Mapbox GL JS habit carries over.

## References

- [AGENTS.md](https://github.com/maplibre/maplibre-agent-skills/blob/main/AGENTS.md) — orientation for agents in this repo; reporting a failure from outside it
- [CONTRIBUTING.md](https://github.com/maplibre/maplibre-agent-skills/blob/main/CONTRIBUTING.md) — the contribution lanes and what each one owes
- [evals/README.md](https://github.com/maplibre/maplibre-agent-skills/blob/main/evals/README.md) — prompts, rubrics, baseline checks, provider setup
- [Agent Skills specification](https://agentskills.io/specification) — the `SKILL.md` contract

---

**This skill is a snapshot.** Where a primary source contradicts it — the References above, MapLibre's current documentation, or what MapLibre does when you run it — that source wins. Follow it, then [report the disagreement](https://github.com/maplibre/maplibre-agent-skills/issues/new?template=ai-failure-report.md), citing the source and your MapLibre version: editing your installed copy helps no one else and is overwritten on the next update.

© maplibre · MIT · maplibre/maplibre-agent-skills

Похожие скиллы

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
mapbox-maplibre-migration mapbox Скилл mapbox-maplibre-migration для Claude Code помогает перенести проект с MapLibre GL JS на Mapbox GL JS. Он подключается к запросам о совместимости API, настройке токена и стилей. CX Codex +1 1 400установок skill-authoring grafana Скилл skill-authoring для Claude Code и других агентов: проверяет SKILL.md по четырём критериям рубрики CI-гейта grafana/skills. Ловит ошибки до ревью. CX Codex +1 4 300установок create-skill NeoLabHQ Скилл create-skill для Claude Code, Codex, Cursor и других агентов, который ведёт через процесс написания нового скилла по методике TDD. Сначала субагент проваливает тест без документа, потом скилл пишется под конкретные нарушения. CX Codex +1 1 300установок open-knowledge-write-skill Inkeep Скилл open-knowledge-write-skill помогает агенту составить новый SKILL.md: выбрать область действия, оформить frontmatter и проверить, что скилл срабатывает в нужный момент. CX Codex +1 6 900установок validate-skills Callstack Скилл validate-skills проверяет скиллы в skills/ по спецификации agentskills.io и практикам Claude Code. Нужен при создании и ревью набора скиллов. CX Codex +1 7 800установок creating-skills fvadicamo Скилл creating-skills для Claude Code помогает создавать и обновлять скиллы, включая SKILL.md. Он подключается по запросу о структуре, правилах именования или настройке скилла. CX Codex +1 208установок

Из того же набора10

Весь набор →
maplibre-pmtiles-patterns Скилл maplibre-pmtiles-patterns для Claude Code разворачивает векторные и растровые тайлы PMTiles в MapLibre GL JS без тайлового сервера. Карты размещаются в S3, Cloudflare R2 или GitHub Pages. CX Codex +1 899установок maplibre-cartography Скилл maplibre-cartography для Claude Code с картографическими правилами MapLibre GL JS: подбирает цвета подписей и значков, порядок слоёв и контраст. Стилизует карту с нуля и возвращает читаемость подписей на снимках. CX Codex +1 623установок maplibre-mapbox-migration Скилл maplibre-mapbox-migration для Claude Code помогает перенести приложение с Mapbox GL JS на MapLibre GL JS. Включается при миграции карты и поиске причин пустого экрана или ошибок mapbox:// и 401. CX Codex +1 532установок maplibre-source-wiring Скилл maplibre-source-wiring для Claude Code разбирает пустую карту MapLibre GL JS, неверные слои и проблемы с подсветкой объектов. Проверяет настроенный источник, если карта ничего не рисует. CX Codex +1 408установок maplibre-fonts-glyphs Скилл maplibre-fonts-glyphs для Claude Code настраивает шрифты и глифы в MapLibre GL JS и MapLibre Native. Разбирает проблемы с подписями, размещение сервера глифов и отображение нелатинских письменностей. CX Codex +1 335установок maplibre-terrain-rendering Скилл maplibre-terrain-rendering учит агента настраивать рельеф в MapLibre GL JS: тени, гипсометрическую окраску через color-relief, горизонтали и 3D-поверхность. CX Codex +1 307установок maplibre-v6-migration Скилл maplibre-v6-migration для Claude Code разбирает семь поломок при переходе с MapLibre GL JS v5 на v6: ESM-сборку, импорты, резолвер иконок, map.transform и типы событий. Выявляет причины пустой карты после обновления. CX Codex +1 286установок maplibre-sprites-icons Скилл maplibre-sprites-icons для Claude Code настраивает спрайты и иконки для MapLibre GL JS в картах. Запускается при выборе между Marker и спрайтом или пропавших иконках слоя. CX Codex +1 136установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой