hex-grid-spatial — скилл для Claude Code
Скилл hex-grid-spatial для Claude Code считает соседей, расстояние и клетки в радиусе на гексагональной карте с odd-r offset координатами. Используется в логике ходов и зон вокруг юнита.
Apache-2.0 1 установок ★ 1 933 обновлён 2026-10-24
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a claude-codeЧто делает hex-grid-spatial
Скилл даёт агенту три готовые функции на Python для гексагональной карты. Координаты трактуются как odd-r offset: ряды с нечётным индексом сдвинуты вправо на полклетки, отсчёт идёт от левого нижнего угла, столбцы растут вправо, ряды вверх. Внутри список шести соседей, расстояние между двумя тайлами через перевод в кубические координаты и выборка клеток в радиусе вокруг точки.
Соседи берутся из таблицы направлений, и для чётного и нечётного ряда она разная. Четыре диагональных направления смещаются на столбец, запад и восток остаются на месте. Перепутаете чётность ряда — список соседей уедет на соседний столбец, поэтому карту с другой раскладкой сначала приводят к odd-r.
Дистанция возвращает число шагов между клетками, а радиус перебирает квадрат вокруг центра и оставляет только те тайлы, что проходят по гекс-расстоянию. На больших радиусах перебор растёт быстро, потому что проверяется весь квадрат.
Какие задачи решает
- найти шесть соседних тайлов для клетки на гекс-карте
- посчитать, сколько шагов между двумя гексами
- собрать все клетки в радиусе вокруг города
- проверить, граничат ли два тайла
- перевести offset-координаты в кубические для расчёта дистанции
Примеры запросов агенту
- Найди соседей тайла (21, 13) на гекс-сетке и покажи их координаты
- Посчитай гекс-расстояние между (21, 13) и (24, 13)
- Собери все клетки в радиусе 3 вокруг центра города (21, 13)
Как установить hex-grid-spatial
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a claude-code2Вручную: положить файлы
~/.claude/skills/hex-grid-spatial/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/hex-grid-spatial/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a codex2Вручную: положить файлы
.agents/skills/hex-grid-spatial/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a cursor2Вручную: положить файлы
.cursor/skills/hex-grid-spatial/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install benchflow-ai/skillsbench tasks/civ6-adjacency-optimizer/environment/skills/hex-grid-spatial2Вручную: положить файлы
.github/skills/hex-grid-spatial/SKILL.md1Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a gemini-cli2Командой платформы
gemini skills install https://github.com/benchflow-ai/skillsbench --path tasks/civ6-adjacency-optimizer/environment/skills/hex-grid-spatialВручную: положить файлы
.devin/skills/hex-grid-spatial/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о hex-grid-spatial
Как установить hex-grid-spatial в Claude Code?
Выполните npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a claude-code. Файл скилла окажется по пути ~/.claude/skills/hex-grid-spatial/SKILL.md.
Что делает hex-grid-spatial?
Даёт агенту функции для гекс-карты: соседи клетки, расстояние между тайлами и все клетки в радиусе. Работает с odd-r offset координатами.
Какая раскладка сетки поддерживается?
Только odd-r offset, где нечётные ряды сдвинуты вправо. Для другой раскладки расстояния и соседи будут неверными, карту нужно привести к odd-r.
Исходный текст
SKILL.md · Apache-2.0
---
name: hex-grid-spatial
description: Hex grid spatial utilities for offset coordinate systems. Use when working with hexagonal grids, calculating distances, finding neighbors, or spatial queries on hex maps.
---
# Hex Grid Spatial Utilities
Utilities for hexagonal grid coordinate systems using **odd-r offset coordinates** (odd rows shifted right).
## Coordinate System
- Tile 0 is at bottom-left
- X increases rightward (columns)
- Y increases upward (rows)
- Odd rows (y % 2 == 1) are shifted right by half a hex
## Direction Indices
```
2 1
\ /
3 - * - 0
/ \
4 5
0=East, 1=NE, 2=NW, 3=West, 4=SW, 5=SE
```
## Core Functions
### Get Neighbors
```python
def get_neighbors(x: int, y: int) -> List[Tuple[int, int]]:
"""Get all 6 neighboring hex coordinates."""
if y % 2 == 0: # even row
directions = [(1,0), (0,-1), (-1,-1), (-1,0), (-1,1), (0,1)]
else: # odd row - shifted right
directions = [(1,0), (1,-1), (0,-1), (-1,0), (0,1), (1,1)]
return [(x + dx, y + dy) for dx, dy in directions]
```
### Hex Distance
```python
def hex_distance(x1: int, y1: int, x2: int, y2: int) -> int:
"""Calculate hex distance using cube coordinate conversion."""
def offset_to_cube(col, row):
cx = col - (row - (row & 1)) // 2
cz = row
cy = -cx - cz
return cx, cy, cz
cx1, cy1, cz1 = offset_to_cube(x1, y1)
cx2, cy2, cz2 = offset_to_cube(x2, y2)
return (abs(cx1-cx2) + abs(cy1-cy2) + abs(cz1-cz2)) // 2
```
### Tiles in Range
```python
def get_tiles_in_range(x: int, y: int, radius: int) -> List[Tuple[int, int]]:
"""Get all tiles within radius (excluding center)."""
tiles = []
for dx in range(-radius, radius + 1):
for dy in range(-radius, radius + 1):
nx, ny = x + dx, y + dy
if (nx, ny) != (x, y) and hex_distance(x, y, nx, ny) <= radius:
tiles.append((nx, ny))
return tiles
```
## Usage Examples
```python
# Find neighbors of tile (21, 13)
neighbors = get_neighbors(21, 13)
# For odd row: [(22,13), (22,12), (21,12), (20,13), (21,14), (22,14)]
# Calculate distance
dist = hex_distance(21, 13, 24, 13) # Returns 3
# Check adjacency
is_adj = hex_distance(21, 13, 21, 14) == 1 # True
# Get all tiles within 3 of city center
workable = get_tiles_in_range(21, 13, 3)
```
## Key Insight: Even vs Odd Row
The critical difference is in directions 1, 2, 4, 5 (the diagonal directions):
| Direction | Even Row (y%2==0) | Odd Row (y%2==1) |
|-----------|-------------------|------------------|
| NE (1) | (0, -1) | (1, -1) |
| NW (2) | (-1, -1) | (0, -1) |
| SW (4) | (-1, +1) | (0, +1) |
| SE (5) | (0, +1) | (1, +1) |
East (0) and West (3) are always (1, 0) and (-1, 0).
© benchflow-ai · Apache-2.0 · benchflow-ai/skillsbench