# spatial

Скилл помогает анализировать географические координаты, границы и файлы GeoJSON или GeoParquet через DuckDB, а также искать объекты в Overture Maps.

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

## Что делает

Скилл подключает расширение `spatial` для DuckDB и выполняет геопространственные запросы через Bash. Если локальных файлов нет, агент подтягивает данные об улицах, зданиях и местах напрямую из открытых датасетов Overture Maps на S3 без ключей API.

Под капотом инструмент генерирует SQL-запросы с функциями `ST_Contains`, `ST_Read` и `ST_Distance_Spheroid`, а также может строить гексагональную сетку H3. При работе с Overture Maps обязательно используется фильтрация по `bbox` до вызова функций, чтобы читать Parquet без скачивания всего массива данных.

Для правильных расчётов скилл выставляет `geometry_always_xy = true`, иначе координаты перепутаются местами. Для работы нужен установленный в системе DuckDB. Если бинарник отсутствует, потребуется сначала поставить сам DuckDB.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add duckdb/duckdb-skills --skill spatial -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add duckdb/duckdb-skills --skill spatial -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add duckdb/duckdb-skills --skill spatial -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install duckdb/duckdb-skills spatial
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add duckdb/duckdb-skills --skill spatial -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add duckdb/duckdb-skills --skill spatial -a opencode
```

### Claude.ai

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

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

## Когда брать
- рассчитать реальное расстояние между координатами на эллипсоиде WGS84
- найти здания или объекты инфраструктуры через Overture Maps
- проверить попадание точек в полигоны через `ST_Contains`
- конвертировать треки GPX или Shapefile в формат GeoJSON

## Примеры запросов агенту
- Найди ближайшие кафе в заданном полигоне через Overture Maps
- Проверь, какие точки из файла `deliveries.csv` попадают в границы `zones.geojson`
- Экспортируй полигоны из `parcels.gpkg` в GeoParquet с помощью DuckDB

## Похожие
- [tooluniverse-spatial-omics-analysis](https://affpapa.org/nevibecode/skills/tooluniverse-spatial-omics-analysis.md) — скилл · 360 установок
- [strategy-compare](https://affpapa.org/nevibecode/skills/strategy-compare.md) — скилл · 2300 установок
- [datapackage](https://affpapa.org/nevibecode/skills/datapackage.md) — скилл · 2100 установок
- [mapbox-data-visualization-patterns](https://affpapa.org/nevibecode/skills/mapbox-data-visualization-patterns.md) — скилл · 2100 установок
- [setup](https://affpapa.org/nevibecode/skills/marketcalls-setup.md) — скилл · 2000 установок
- [geomaster](https://affpapa.org/nevibecode/skills/geomaster.md) — скилл · 1900 установок

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

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

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