К основному содержанию
скилл CX Codex

hex-grid-spatial — скилл для Claude Code

Скилл hex-grid-spatial для Claude Code считает соседей, расстояние и клетки в радиусе на гексагональной карте с odd-r offset координатами. Используется в логике ходов и зон вокруг юнита.

Apache-2.0 1 установок ★ 1 933 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add benchflow-ai/skillsbench --skill hex-grid-spatial -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/hex-grid-spatial/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/hex-grid-spatial/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
Moddable Games Tools Moddable-Games MCP-сервер Moddable Games Tools подключает к ассистенту функции анализа шахматных вариантов, процедурной генерации гексагональных карт и утилиты для настольных игр. Помогает модели работать с правилами и бросками кубиков. CX Codex +1 game-ai gamedev-skills Скилл game-ai для Claude Code помогает проектировать и отлаживать искусственный интеллект для врагов и NPC, независимый от игрового движка. CX Codex +1 14 100установок unity-navmesh gamedev-skills Скилл unity-navmesh для Claude Code настраивает поиск пути в Unity через NavMesh. Он включается, когда NPC должен преследовать цель или патрулировать, агент не движется либо путь получается неполным. CX Codex +1 10 900установок roblox-npc-ai TabooHarmony Скилл roblox-npc-ai для Claude Code, Codex, Cursor, Copilot, Gemini CLI и OpenCode. Добавляет агенту знание Roblox PathfindingService, машин состояний для NPC, линии видимости и серверных AI-петель. CX Codex +1 3 400установок godot-genre-rts thedivergentai Скилл godot-genre-rts для Claude Code содержит рецепты для создания RTS в Godot: выделение юнитов, очередь приказов, туман войны, экономика и ИИ-противники. CX Codex +1 365установок godot-genre-tower-defense thedivergentai Скилл godot-genre-tower-defense для Claude Code и других агентов: волны, приоритеты целей, поиск пути и баланс экономики tower defense на Godot. Покрывает переход от одной башни к системе. CX Codex +1 361установок

Из того же набора22

Весь набор →
meteorology-driver-classification Скилл meteorology-driver-classification раскладывает переменные климатического датасета по группам «тепло», «поток», «ветер» и «человек», чтобы считать вклад каждой в изменения системы. CX Codex +1 2установок scipy-curve-fit Скилл scipy-curve-fit обучает агента подбирать параметры нелинейных моделей по экспериментальным данным через scipy.optimize.curve_fit. CX Codex +1 2установок python-scala-idioms Скилл python-scala-idioms помогает переводить код с Python на чистый и идиоматичный Scala. Фокусируется на неизменяемости, сопоставлении с образцом и безопасной работе с типами. CX Codex +1 1установок first-order-model-fitting Скилл first-order-model-fitting для Claude Code подбирает модель первого порядка по экспериментальному переходному отклику и оценивает K и tau. Анализирует тепловые, электрические и механические системы. CX Codex +1 1установок python-scala-syntax-mapping Скилл python-scala-syntax-mapping для Claude Code сопоставляет синтаксис Python и Scala, помогая ИИ-агенту переносить функции, циклы и типы данных. CX Codex +1 1установок image-ocr Скилл image-ocr извлекает текст из изображений через Tesseract OCR и Python. Попросите агента обработать скан, скриншот или папку с картинками. CX Codex +1 1установок audiobook Скилл audiobook собирает аудиокнигу из статьи по ссылке или текстового файла: вытягивает контент, чистит его и озвучивает через ElevenLabs, OpenAI TTS или gTTS. CX Codex +1 1установок nanogpt-training Скилл nanogpt-training для Claude Code содержит инструкции для обучения моделей масштаба GPT-2 на 124M параметров на одной GPU с оптимизатором Muon и данными из Hugging Face. CX Codex +1 1установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой