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

relate · relatedb, python — скилл для Claude Code: работа с графом

Скилл для Claude Code помогает писать Python-код для локальной графовой базы Relate с запросами openCypher. Подключается к задачам создания базы, выполнения запросов Cypher и обработки результатов.

Apache-2.0 ★ 423 обновлён 2026-11-16

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

Что делает relate

Скилл объясняет, как подключать Python-пакет relate и работать с встроенной графовой базой openCypher. Он охватывает параметры запросов, транзакции и обработку результатов: записи можно преобразовать в словари, DataFrame или Arrow-таблицы, а графовые объекты — извлечь для визуализации.

Пакет устанавливается командой pip install relate-db; для to_arrow() нужен extra arrow, а для to_df() — pandas. База хранится в локальной директории, файле .rl или в памяти. На одну базу допускается только один процесс записи, а соединение привязано к потоку, который его открыл.

Какие задачи решает

  • создать локальную графовую базу из Python
  • выполнить Cypher-запрос с параметрами
  • обработать результаты запроса как DataFrame или Arrow-таблицу
  • извлечь графовые объекты из результата для визуализации

Примеры запросов агенту

  • Напиши Python-код, который создаёт локальную базу Relate и добавляет в неё узлы через Cypher.
  • Покажи, как передать параметры в Cypher-запрос через relate.
  • Преобразуй результат запроса relate в DataFrame и извлеки из него граф для визуализации.

Как установить relate

1Через Skills CLI (Vercel)

npx skills add relatedb/relate --skill relate -a claude-code

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

~/.claude/skills/relate/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о relate

Как установить relate в Claude Code?

Выполни npx skills add relatedb/relate --skill relate -a claude-code. Файл скилла находится по пути ~/.claude/skills/relate/SKILL.md.

Что делает скилл relate?

Помогает писать Python-код для подключения к локальной графовой базе Relate и выполнения запросов openCypher. Описывает транзакции и способы обработки результатов, включая DataFrame, Arrow и извлечение графа.

Что нужно для работы с relate?

Нужен Python-пакет relate-db, который устанавливается командой pip install relate-db. Для преобразования результатов в Arrow-таблицу нужен extra arrow, а для DataFrame — pandas.

Исходный текст

SKILL.md · Apache-2.0
---
name: relate
description: Relate is an embedded openCypher graph database, and this is its Python package (import relate). Use this skill when writing Python code that creates, queries, or embeds a local graph database with Cypher — connecting, parameters, transactions, result handling (records, DataFrames, Arrow, graph extraction), and visualization.
---

# Relate (Python)

Relate embeds a full openCypher engine in-process (Rust core, PyO3
extension; no server, no subprocess). `pip install relate-db` —
`import relate`. Databases are a local directory, `:memory:`, or a
`.rl` file. One writer process per database.

## Connect and query

```python
import relate

db = relate.connect("./mydata")           # or ":memory:" / "./task.rl"
db.execute("CREATE (p:Person {name: $name})", {"name": "Alice"})
for row in db.execute("MATCH (p:Person) RETURN p.name AS name"):
    print(row["name"], row.name)               # dict access and attribute access
db.close()
```

Parameters are `$name`, passed as a plain dict with string keys
(ADR-0219): `uuid.UUID` crosses as its canonical string,
`bytes`/`bytearray` as a list of byte values 0–255, tuples as lists, and
dicts are always maps — a `{"srid": …, "x": …, "y": …}` dict is NOT
silently turned into a point; pass `relate.Point(srid, x, y)` or use
`point($coords)` in Cypher. Non-dict params or non-string keys raise
`relate.ProgrammingError`, and so does a statement that references a
parameter missing from the dict (`ParameterMissing: Expected
parameter(s): <names>`) — pass `None` for null, never omit the key.
Transactions:
`db.autocommit = False`, then `db.commit()` / `db.rollback()` — closing
with an open transaction rolls back. `db.commit()` returns the
transaction's bookmark (`relate:<n>`, the engine's commit sequence,
increasing per store; `None` if nothing was written); an auto-commit
write's bookmark is `cursor.consume().bookmark`. Read-only access (multiple readers
per database, no writes or checkpoints):
`relate.connect(path, read_only=True)` — the store must exist.

## Result handling

Every row is a `Record` — a `dict` with read-only attribute access,
`.data()` (Neo4j-driver form: nodes/relationships become property dicts, paths
alternate node dicts and relationship types), `.to_dict()` (JSON-ready and
lossless: nodes keep `id`/`element_id`/`labels`/`properties`, relationships
add `type`/endpoint ids, paths are `{nodes, relationships}` — use this for
text2cypher output), and column-ordered `.keys()`. The cursor carries the Neo4j
driver's conveniences: `single()` (exactly one row or `ResultNotSingleError`),
`peek()`, `fetch(n)`, `data()`, `keys()`, and `consume()` — a
`ResultSummary` with the mutation counters, resolved namespace, query
type, `bookmark` (`relate:<n>` after an auto-commit write, else
`None`), `elapsed_ms` (engine-reported statement elapsed, ADR-0221) with its
`parse_ms`/`plan_ms`/`execute_ms` phase split (ADR-0491 — the PARSE /
PLAN / EXECUTE sub-windows of the total, answering where a slow statement
spends its time), and
`notifications` — the engine-native query-notification list (ADR-0363;
empty on a plain run, populated by `EXPLAIN`/`PROFILE`) — and `plan`, the
structured `relate.plan/v1` document (LABS-370, ADR-0381; `None` on a
plain run): the operator tree with per-node estimates, PROFILE metrics
(including the read-kind mix, the seek/walk phase times, the cumulative
`total_time_ms`, the arm's `loops`, the walk's start, `batched` —
whether the operator ran the batch scan/filter/project chain, and
`zone_skips` — how many conjunct-batch evaluations that chain's filter
provably replaced with the correct empty survivor set via the chunk's
derived per-column min/max zone) and the
operator's remedy-bearing warnings. Reach for `summary.plan` when a query is slow:
the `actual` numbers and the warnings name the operator to fix.
`cursor.description` type codes come from the engine-reported column
types (ADR-0224): `STRING`/`BINARY` map to themselves,
`INTEGER`/`FLOAT`/`BOOLEAN` fold into `NUMBER`, `DATETIME`/`DATE`/`TIME`
fold into `DATETIME`, and graph, spatial, list, map and duration columns
— plus `ANY` (empty or `Null` first row) — report `None`.

```python
cur = db.execute("MATCH (p:Person) RETURN p.name AS name, p.age AS age")
cur.to_arrow()   # pyarrow.Table — pip install relate-db[arrow]
cur.to_df()      # pandas DataFrame — pip install relate-db[pandas]
```

`cur.graph()` returns the result's graph entities — every `Node`,
`Relationship`, `Path` in the rows (nested values walked), de-duplicated
by id — as a `ResultGraph` (`nodes`, `relationships`, id-ordered). Nodes
and relationships expose `id`, `labels`/`type`, `properties`,
`element_id` (exactly Cypher's `elementId()`: `4:rl-id:n0` /
`5:rl-id:r0`, so `WHERE elementId(n) = $id` finds it again),
`items()`, and `start`/`end`; relationships add `start_node_element_id` /
`end_node_element_id`. This is viz-independent:
convert to networkx/igraph without a bridge dependency (see
`references/networkx-igraph.md`), or render with the optional
`relate.viz.to_visualization_graph(cur)` (neo4j-viz).

## The native API

`relate.Database` is the thin native handle under `connect()` — use it
for `execute_arrow()` (Arrow IPC stream bytes), engine lifecycle
(`flush`, explicit transactions), or its `QueryResult` (dict rows
plus `namespace` / `query_type` / `bookmark` / `column_types` /
`notifications` / `plan`).
Everything ergonomic lives on the DB-API side; see
`references/native-api.md` for the comparison.

## Gotchas

- `:memory:` vanishes on close — use a path for durable work.
- One writer per database; multiple read-only processes are fine.
- Connections are thread-affine (`threadsafety` 1): use one only on the
  thread that opened it — any other thread gets a `ProgrammingError` (not
  fatal for the owning thread), and a foreign-thread drop is safe. In
  threaded servers, own the connection on one dedicated worker thread (or
  use `:memory:` per thread).
- Errors carry the engine's classification on every `relate.Error`:
  `e.neo4j_code`, `e.gql_status`, `e.stage` (`compile`/`runtime`/
  `internal`) and `e.retryable` — retry a transaction only when
  `e.retryable` is true (a write-write conflict). All four are `None` on a
  binding-level misuse (closed connection, wrong thread).
- Write counters live on `cursor.stats` (11 counters, zero-padded; Neo4j's
  counting: labels per node, every property write, schema DDL counted).
- Temporal values are `datetime` objects when stdlib carries them losslessly
  (microsecond-aligned, offset only); a value with sub-microsecond nanoseconds
  or an IANA zone name comes back as `relate.Temporal` — read `.text` (the
  engine's canonical ISO text, also `str()`), `.nanosecond`, `.zone_name`,
  `.offset_seconds`, or `.to_native()` for the lossy stdlib value. Nodes come
  back as rich `Node` objects, not dicts.
- Durations are always `relate.Duration` (`.months`, `.days`,
  `.seconds`, `.nanoseconds`; `str()` is the ISO text) — never a
  `timedelta`, so `PT36H != P1DT12H`. `.to_timedelta()` is the explicit
  lossy projection (raises `ValueError` on months or sub-µs). Bind
  `relate.Duration(months=1)` for a month duration.
- Vectors are `relate.Vector` (`.coordinate_type`, `.dimension`,
  `.values`) at every depth, never a dict; a returned one binds back as a
  parameter. Build new ones in Cypher: `vector($list, 3, FLOAT32)`.
- `bytes`/`bytearray` parameters arrive as a `LIST<INTEGER>` (0–255) and
  come back as a `list` of `int`; the engine's real byte array (ADR-0327)
  is Bolt-only and cannot be stored as a property.

Full spec: https://github.com/relatedb/relate — `docs/api/python/`.

© relatedb · Apache-2.0 · relatedb/relate

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

Все скиллы по теме «Языки программирования» →

Сначала — relate от других авторов.

relate relatedb Помогает подключать в JVM-приложения локальную графовую базу Relate и выполнять запросы на Cypher. Срабатывает при работе с Java- и Kotlin-кодом, который создаёт или использует такую базу. CX Codex +1 ★ 423звёзд репо relate relatedb Помогает писать JavaScript и TypeScript-код для локальной графовой базы Relate с запросами openCypher. Он охватывает подключение, транзакции и разбор результатов. CX Codex +1 ★ 423звёзд репо svelte5-best-practices ejirocodes Скилл svelte5-best-practices для ИИ-агента, который подсказывает руны Svelte 5, сниппеты и паттерны SvelteKit при написании и рефакторинге компонентов. CX Codex +1 18 800установок solana-mobile solana-mobile Скилл проводит через создание, настройку и отладку Solana Mobile приложений на Android: шаблоны Expo, проверка тулчейна, эмуляторы, локальный валидатор. CX Codex +1 14 300установок msw-scripting MSW-Git Скилл msw-scripting помогает писать скрипты .mlua для MapleStory Worlds, соблюдая архитектуру компонентов и пространств выполнения. Пригодится при разработке игровой логики и отладке в MSW. CX Codex +1 11 000установок seeker-connect solana-mobile Скилл seeker-connect подключает веб-, React Native- и Kotlin-приложения к встроенному кошельку на телефоне Seeker: вход через Solana, подпись сообщений и транзакций. CX Codex +1 9 700установок tauri-v2 nodnarbnitram Подсказывает агенту, как писать команды на Rust, настраивать IPC и capabilities в Tauri v2, и не даёт наступить на типовые грабли сборки. CX Codex +1 8 500установок apollo-client apollographql Скилл apollo-client для Claude Code помогает собирать React-приложения с Apollo Client 4.x. Он включается при настройке клиента, работе с GraphQL-запросами и мутациями или разборе ошибок. CX Codex +1 5 900установок

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

Весь набор →
release-notes Промпт release-notes для Claude Code готовит заметки к выпуску relate по журналу изменений и истории коммитов. Запускается для помеченного тега релиза. CX Codex +1 ★ 423звёзд репо security-review Скилл security-review для Claude Code проверяет изменения кода с точки зрения безопасности и предлагает способы устранить риски. CX Codex +1 ★ 423звёзд репо neo4j-query-workload-skill Скилл neo4j-query-workload-skill для Claude Code наращивает набор запросов к графовой базе по одному требованию за раунд. Он проверяет новые запросы на данных и выявляет регрессии в уже проверенной нагрузке. CX Codex +1 ★ 423звёзд репо relate Помогает подключать в JVM-приложения локальную графовую базу Relate и выполнять запросы на Cypher. Срабатывает при работе с Java- и Kotlin-кодом, который создаёт или использует такую базу. CX Codex +1 ★ 423звёзд репо relate Помогает писать JavaScript и TypeScript-код для локальной графовой базы Relate с запросами openCypher. Он охватывает подключение, транзакции и разбор результатов. CX Codex +1 ★ 423звёзд репо rust-reviewer Скилл rust-reviewer для Claude Code и Codex проверяет Rust-код на ошибки владения, работы с временами жизни и обработки ошибок. Запускает полный обзор проекта, включая аудит unsafe и проверку идиоматичного Rust. CX Codex +1 ★ 423звёзд репо agent-backlog-autopilot Скилл agent-backlog-autopilot для Claude Code проводит одну задачу из агентского бэклога от выбора карточки до PR. После зелёных draft-проверок он ждёт, пока человек разрешит сделать PR готовым к ревью. CX Codex +1 ★ 423звёзд репо stellar-code-quality-review Скилл stellar-code-quality-review для Claude Code строго проверяет поддерживаемость кода, качество абстракций и рост файлов. Запускает поэтапный аудит изменений и связанных с ними участков. CX Codex +1 ★ 423звёзд репо

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

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