# maplibre-tile-sources

Помогает решить, что подойдёт набору данных в MapLibre GL JS: GeoJSON прямо из файла или векторные и растровые тайлы. Нужен на старте карты, до настройки хостинга.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 982 установки · ★ 155
- Автор: maplibre
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/maplibre/maplibre-agent-skills/tree/HEAD/skills/maplibre-tile-sources/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/maplibre-tile-sources

## Что делает

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

Отдельный блок — GeoJSON без тайлового сервера. Данные целиком скачиваются в браузер, поэтому скилл приводит пороги по размеру файла и числу объектов. До 2 МБ и 5000 объектов загрузка идёт без задержек; от 5 до 20 МБ и примерно до 50 000 объектов появляется пауза на разбор, а на мобильных становится тяжело; свыше 50 МБ и 100 000 объектов браузер рискует зависнуть. Если набор больше, скилл предлагает перейти на векторные тайлы.

Ещё он объясняет, как фоновая карта и ваши данные уживаются отдельными источниками в одном стиле, и какие типы источников вообще бывают: `vector`, `raster`, `raster-dem`, `geojson`, `image`, `video`. Настройка и подключение уже сконфигурированного источника — не его тема, для этого в наборе есть соседний скилл. Учтите: `sprite` не имеет запасного варианта, пропущенная иконка просто не отрисуется, так что оба ресурса в продакшен-стиле стоит задавать явно.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maplibre/maplibre-agent-skills --skill maplibre-tile-sources -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/maplibre-tile-sources/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/maplibre-tile-sources/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maplibre/maplibre-agent-skills --skill maplibre-tile-sources -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/maplibre-tile-sources/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maplibre/maplibre-agent-skills --skill maplibre-tile-sources -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/maplibre-tile-sources/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install maplibre/maplibre-agent-skills maplibre-tile-sources
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/maplibre-tile-sources/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add maplibre/maplibre-agent-skills --skill maplibre-tile-sources -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/maplibre/maplibre-agent-skills --path skills/maplibre-tile-sources
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/maplibre-tile-sources/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add maplibre/maplibre-agent-skills --skill maplibre-tile-sources -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/maplibre/maplibre-agent-skills/tree/HEAD/skills/maplibre-tile-sources/SKILL.md

## Когда брать
- выбрать между GeoJSON и тайлами для конкретного набора данных
- оценить, нужна ли тайловая инфраструктура вообще
- понять, при каком размере файла GeoJSON начнёт тормозить в браузере
- разложить фоновую карту и свои данные по отдельным источникам
- подобрать тип источника под точки, линии или полигоны

## Примеры запросов агенту
- У меня 30 000 адресов магазинов, GeoJSON или векторные тайлы?
- Объясни, как собрать стиль MapLibre, где фон и мои полигоны — разные источники
- Файл GeoJSON весит 60 МБ, карта подвисает. Что делать?

## Похожие
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок
- [prototype](https://affpapa.org/nevibecode/skills/prototype.md) — скилл · 986201 установка
- [hyperframes](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes.md) — скилл · 1200000 установок
- [hyperframes-cli](https://affpapa.org/nevibecode/skills/heygen-com-hyperframes-cli.md) — скилл · 1300000 установок
- [webapp-testing](https://affpapa.org/nevibecode/skills/webapp-testing.md) — скилл · 186758 установок

Из того же набора: [maplibre/maplibre-agent-skills](https://affpapa.org/nevibecode/by/maplibre/maplibre-agent-skills.md) — 4 карточки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md