Authoring a Skill From a Session

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 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 has the agent-specific rules and 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: