# maplibre-terrain-rendering

Скилл maplibre-terrain-rendering учит агента настраивать рельеф в MapLibre GL JS: тени, гипсометрическую окраску через color-relief, горизонтали и 3D-поверхность.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 307 установок · ★ 164 у репозитория
- Автор: maplibre
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/maplibre/maplibre-agent-skills/tree/HEAD/skills/maplibre-terrain-rendering/SKILL.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/maplibre-terrain-rendering

## Что делает

Этот скилл помогает агенту правильно работать с источниками `raster-dem` в MapLibre GL JS. Вместо устаревшего наложения нескольких слоёв теней он переводит конфигурацию на свойство `hillshade-method` со значениями `multidirectional` или `igor`. Это избавляет карту от проваленных теней и лишних проходов рендеринга.

Внутри разобраны четыре сценария: светотеневая пластика через слой `hillshade`, высотная раскраска слоем `color-relief` с выражением `["elevation"]`, генерация горизонталей в Web Worker через библиотеку `maplibre-contour` и 3D-рельеф через `map.setTerrain()`. Скилл сразу предостерегает от свойств вроде `raster-color`, которые есть только в Mapbox GL JS и молча игнорируются движком MapLibre.

Учтите требование к версии: слой `color-relief` доступен только начиная с MapLibre GL JS 5.6, а `hillshade-method` появился в 5.5.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install maplibre/maplibre-agent-skills skills/maplibre-terrain-rendering
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- исправить резкие контрасты и выбитые тени рельефа на карте
- настроить окрашивание высот на клиенте через слой color-relief
- построить изолинии высот прямо в браузере через maplibre-contour
- устранить плоский вид карты при включённом map.setTerrain

## Примеры запросов агенту
- Настрой мягкую отмывку рельефа через multidirectional hillshade в MapLibre GL JS
- Добавь клиентскую цветовую шкалу высот для raster-dem через слой color-relief
- Сгенерируй горизонтали из DEM-тайлов на клиенте с помощью библиотеки maplibre-contour

## Похожие
- [mapbox-maplibre-migration](https://affpapa.org/nevibecode/skills/mapbox-maplibre-migration.md) — скилл · 1400 установок
- [seamless-isometric-terrain](https://affpapa.org/nevibecode/skills/seamless-isometric-terrain.md) — скилл · ★ 51 у репозитория
- [terrain-hydrology](https://affpapa.org/nevibecode/skills/terrain-hydrology.md) — скилл · ★ 48 у репозитория
- [threejs-landscape](https://affpapa.org/nevibecode/skills/threejs-landscape.md) — скилл · 1600 установок
- [pixijs-rendering](https://affpapa.org/nevibecode/skills/pixijs-rendering.md) — скилл · 10800 установок
- [pixijs-custom-rendering](https://affpapa.org/nevibecode/skills/pixijs-custom-rendering.md) — скилл · 7000 установок

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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