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

relate · relatedb, resources — скилл для Claude Code: что делает и как установить

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

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

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

Что делает relate

Скилл описывает работу с Java-библиотекой Relate: добавление зависимости Maven или Gradle, открытие базы, выполнение запросов на Cypher и привязку типизированных параметров. Он также разбирает транзакции, пространства имён, строки результатов, метаданные запросов и режим чтения без записи.

Relate работает внутри процесса и хранит базу в локальном каталоге, файле .rl или памяти. Нужна Java 17 или новее. Для одной базы допускается только один процесс-записыватель, а база :memory: исчезает после завершения JVM. Скилл описывает типы результатов, планы запросов и обработку ошибок.

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

  • добавить Relate как зависимость Maven или Gradle
  • открыть локальную графовую базу и выполнить запрос Cypher
  • передать типизированные параметры и обработать строки результата
  • настроить транзакцию или доступ только для чтения

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

  • Покажи, как открыть базу Relate и выполнить запрос Cypher из Java.
  • Добавь зависимость Relate через Gradle и привяжи параметры к запросу.
  • Настрой транзакцию и чтение графа без записи в проекте на Kotlin.

Как установить 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?

Скилл объясняет, как использовать Java-библиотеку Relate для локальной графовой базы с запросами Cypher: от подключения зависимости до транзакций и чтения результатов.

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

Нужна Java 17 или новее и библиотека Relate, подключённая через Maven или Gradle. Для одной базы разрешён один процесс-записыватель.

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

SKILL.md · Apache-2.0
---
name: relate
description: Relate is an embedded openCypher graph database, and this is its Java (JVM) library. Use this skill when writing Java, Kotlin or other JVM code that creates, queries, or embeds a local graph database with Cypher — adding the Maven/Gradle dependency, opening a database, running statements, binding typed parameters, transactions, namespaces, typed result rows and metadata, query notifications and plans, and read-only access.
---

# Relate (Java)

Relate embeds a full openCypher engine in-process (Rust core over the C
ABI, bound through JNA; no server, no subprocess). Every call is
synchronous. Databases are a local directory, `":memory:"`, or a `.rl`
file. One writer process per database. Java 17+.

## Dependency

The plain artifact bundles the native library for all five supported
platforms (darwin-arm64, darwin-x64, linux-arm64, linux-x64, win32-x64) —
no environment variable, no library path:

```xml
<dependency>
  <groupId>ai.relatedb</groupId>
  <artifactId>relate</artifactId>
  <version>${relate.version}</version>
</dependency>
```

For a smaller deployable, depend on one platform's classifier jar instead
(`osx-aarch_64`, `osx-x86_64`, `linux-aarch_64`, `linux-x86_64`,
`windows-x86_64` — the os-maven-plugin `${os.detected.classifier}` /
Gradle osdetector vocabulary). A classpath without the running platform's
native fails at first use with a `RelateException` naming the platform
and the classifier to add.

## Connect and query

```java
import ai.relatedb.Database;

try (Database db = Database.open("./mydata");      // or ":memory:" / "./task.rl"
     Database.Connection conn = db.connect()) {    // or db.connect("system")
    conn.query("CREATE (p:Person {name: 'Alice'})");
    Database.Result result = conn.query(
            "MATCH (p:Person) WHERE p.name = $name RETURN p.name AS name",
            java.util.Map.of("name", "Alice"));
    result.columns();   // List<String>: ["name"]
    result.rows();      // List<List<Object>>: [["Alice"]]
}
```

`query(cypher, params)` binds named parameters typed (one putter per Java
type — see Results below for the bindable types). Transactions:
`conn.begin()` / `conn.commit()` / `conn.rollback()`; `commit()` returns
the transaction's bookmark (`"relate:<n>"`, or null when the
transaction committed nothing). Read-only access:
`Database.openReadOnly(path)` — the store must exist; no writes or
checkpoints. `db.checkpoint()` folds the WAL into a checkpoint. `Database`
and `Connection` are `AutoCloseable` — close them (a file store cannot be
reopened in the same JVM otherwise).

## Results

Rows are positional lists in `columns()` order; cells hydrate typed through
the value walker (ABI v2, ADR-0502) — no JSON decode:

- Scalars: `Long` (every Cypher integer, the full int64 range), `Double`,
  `Boolean`, `String` (an interior `\u0000` survives), `null`.
- Graph entities: `Node` (elementId, id, labels, properties),
  `Relationship` (elementId, id, start/end element ids and their numeric
  start/end ids, type, properties), `Path` (alternating
  node, relationship, …, node) — records, not kind-tagged maps.

A map *key* holding an interior `\u0000` throws `RelateException` —
the C ABI's map lookup takes a NUL-terminated key, and the client refuses
the read rather than return the wrong key's value (string values keep
theirs).
- Temporals: `java.time` `LocalDate` / `LocalTime` / `OffsetTime` /
  `LocalDateTime` / `OffsetDateTime` / `ZonedDateTime` (zoned when the
  value keeps a zone, offset-only otherwise); durations as
  `DurationValue(months, days, seconds, nanos)`; points and vectors as
  `Point` / `VectorValue`.

`elementId` is the primary identity (`WHERE elementId(n) = $id`
round-trips); the `id` / `startId` / `endId` longs are the deprecated
legacy numeric ids (ADR-0506) — the values `id(n)` / `id(r)` /
`id(startNode(r))` / `id(endNode(r))` return.

The same types bind as parameters, plus `List` and `Map` (nested to any
depth); an unsupported Java type throws `IllegalArgumentException`.

- `getQueryType()` — `QueryType` enum `READ`, `WRITE`, `READ_WRITE` or `SCHEMA` (plan-time; `EXPLAIN`
  reports the wrapped statement's type without running it).
- `getNamespace()` — the resolved namespace: `Namespace` enum `NEO4J`, `SYSTEM` or
  `SYSTEM_ONTOLOGIES`.
- `getBookmark()` — `"relate:<n>"` after an auto-commit write, `null`
  when the statement committed nothing. Order bookmarks by the numeric
  `n`, not string order (`"relate:10"` sorts before `"relate:9"`).
- `getNotifications()` — typed `Notification`s (code, GQLSTATUS,
  `Severity`/`Category` enums, title, description, remedy, operator id); empty on a
  plain run, populated by `EXPLAIN` / `PROFILE`.
- `getPlan()` — the `relate.plan/v1` document for `EXPLAIN` /
  `PROFILE`, `null` on a plain run.

## Gotchas

- **Parameter binding is typed** — bind values with
  `query(cypher, Map.of(...))`; never concatenate untrusted input into the
  statement text.
- Errors throw typed exceptions: `TransientException` exactly when the
  engine marked the failure retryable (catch it to retry; a failed commit
  ends the transaction), `ClientException` for `Neo.ClientError.*`,
  `DatabaseException` for `Neo.DatabaseError.*`. Every one carries
  `getCode()`, `getGqlStatus()`, `getStage()` (the closed enum
  `RelateException.Stage`: `COMPILE` / `RUNTIME` / `INTERNAL`) and
  `isRetryable()` — classify on those, never on message text.
- `":memory:"` vanishes when the JVM exits — use a path for durable work.
- The bundled native is extracted once per version into the user cache
  (`~/Library/Caches/relate`, `$XDG_CACHE_HOME`/`~/.cache/relate`,
  `%LOCALAPPDATA%\relate`); relocate it with
  `-Drelate.native.cache=<dir>` (read-only home, `noexec` mounts).
- `RELATE_LIB` overrides the bundled native — a development escape
  hatch for a self-built library, not a deployment mechanism.
- JDK 24+ prints a JNI "restricted method" warning (JEP 472); silence it
  with `--enable-native-access=ALL-UNNAMED`.

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

© relatedb · Apache-2.0 · relatedb/relate

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

Все скиллы по теме «Данные и базы» →

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

relate relatedb Помогает писать Python-код для локальной графовой базы Relate с запросами openCypher. Подключается к задачам создания базы, выполнения запросов Cypher и обработки результатов. CX Codex +1 ★ 423звёзд репо relate relatedb Помогает писать JavaScript и TypeScript-код для локальной графовой базы Relate с запросами openCypher. Он охватывает подключение, транзакции и разбор результатов. CX Codex +1 ★ 423звёзд репо spring-data-neo4j giuseppe-trisciuoglio Скилл spring-data-neo4j для Claude Code и других AI-кодеров. Работает с графовой БД Neo4j в Spring Boot приложениях: описывает узлы и рёбра графа, пишет Cypher-запросы, настраивает репозитории и тестирует с embedded базами. CX Codex +1 4 000установок neo4j-cypher-guide tomasonjo Скилл neo4j-cypher-guide помогает генерировать современные Cypher-запросы для чтения данных в Neo4j и выбирать подходящие паттерны для обхода графа. CX Codex +1 1установок neo4j-cypher-skill neo4j-contrib Скилл neo4j-cypher-skill для Claude Code и Codex помогает писать, оптимизировать и проверять запросы Cypher 25 к Neo4j 2025.x и 2026.x, включая векторный поиск, подзапросы и массовые операции. CX Codex +1 1 600установок neo4j-modeling-skill neo4j-contrib Скилл neo4j-modeling-skill для Claude Code и Codex. Помогает проектировать, ревью и рефакторить графовые модели Neo4j. CX Codex +1 1 200установок graph-database-expert martinholovsky Скилл graph-database-expert помогает проектировать графовые схемы, составлять обходы и оптимизировать запросы. Сфокусирован на SurrealDB, но поддерживает Cypher и общие графовые паттерны. CX Codex +1 271установок graph-schema pproenca Скилл graph-schema для Claude Code помогает проектировать, проверять и перерабатывать схемы графовых баз данных. Он включается при моделировании узлов и связей или переносе предметной области в граф. CX Codex +1 239установок

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

Весь набор →
opencode-review-protocol Промпт opencode-review-protocol для Claude Code задаёт протокол ревью кода в pull request. Агент оставляет замечания к строкам, публикует сводку и записывает вердикт для CI. CX Codex +1 ★ 423звёзд репо 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 Помогает писать Python-код для локальной графовой базы Relate с запросами openCypher. Подключается к задачам создания базы, выполнения запросов Cypher и обработки результатов. 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звёзд репо

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

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