# neo4j-cypher-skill

Помогает писать, оптимизировать и проверять запросы Cypher 25 для Neo4j 2025.x и 2026.x. Пригодится, когда нужно разобраться с медленным MATCH или собрать пакетную запись.

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

## Что делает

Скилл подключается к агенту и подсказывает синтаксис Cypher 25: `MATCH`, `MERGE`, `CREATE`, `WITH`, `RETURN`, `CALL`, `UNWIND`, `FOREACH`, `LOAD CSV`, `SEARCH`, выражения, функции, индексы и подзапросы. Перед генерацией запроса он требует схему: если в проекте лежит файл вида `<db-name>-schema.json`, берёт метки и типы связей оттуда, иначе просит выполнить `CALL db.schema.visualization()`, `SHOW INDEXES` и `SHOW CONSTRAINTS`. Без схемы скилл выдаёт только набросок вне блока кода и не подставляет придуманные имена.

Внутри есть готовые шаблоны: `MERGE` по ключу с ограничением, область видимости `WITH`, подзапросы `EXISTS`, `COUNT`, `COLLECT`, `CALL (p) { ... }` и пакетная запись через `CALL IN TRANSACTIONS`. Отдельная таблица стиля задаёт PascalCase для меток, SCREAMING_SNAKE_CASE для типов связей и camelCase для свойств. По умолчанию скилл ставит `CYPHER 25` первым токеном и `LIMIT 25` на разведочные чтения.

Базовый ориентир совместимости — Neo4j 2025.01. Клаузы `LET`, `FINISH`, `FILTER` и `INSERT` из GQL-конформности появились позже, в основном в 2025.06, поэтому на старых версиях скилл откатывается к `WITH`, `WHERE` и `CREATE`. Миграция драйверов и правки API — не его дело, для этого есть `neo4j-migration-skill`. Администрирование базы, пользователи, конфиги и бэкапы тоже мимо: это `neo4j-cli-tools-skill`. Гибридный поиск, где векторный индекс смешивается с полнотекстовым, отдан `neo4j-vector-index-skill`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install neo4j-contrib/neo4j-skills neo4j-cypher-skill
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- написать запрос Cypher 25 с нуля под конкретную схему
- разобраться, почему медленный MATCH с переменной длиной пути
- собрать пакетную запись из CSV через CALL IN TRANSACTIONS
- проверить, что метка и тип связи существуют в схеме
- переписать устаревший CALL { WITH x ... } на CALL (x) { ... }

## Примеры запросов агенту
- напиши Cypher-запрос: найди всех Person, кто знает больше 5 человек, отсортируй по числу связей
- оптимизируй этот MATCH — он тормозит на обходе переменной длины
- загрузи data.csv в граф через LOAD CSV и CALL IN TRANSACTIONS, по 1000 строк за раз

## Похожие
- [spring-data-neo4j](https://affpapa.org/nevibecode/skills/spring-data-neo4j.md) — скилл · 3800 установок
- [neo4j-docker-client-generator](https://affpapa.org/nevibecode/agents/neo4j-docker-client-generator.md) — субагент · 183 установки
- [amazon-neptune](https://affpapa.org/nevibecode/skills/amazon-neptune.md) — скилл · 1400 установок
- [Knowledge Graph Builder](https://affpapa.org/nevibecode/skills/knowledge-graph-builder.md) — скилл · 433 установки
- [veritasgraph](https://affpapa.org/nevibecode/mcp/veritasgraph.md) — MCP-сервер · ★ 325
- [xlsx](https://affpapa.org/nevibecode/skills/xlsx.md) — скилл · 187223 установки
- [google-agents-cli-observability](https://affpapa.org/nevibecode/skills/google-agents-cli-observability.md) — скилл · 511300 установок
- [caveman-evidence-review](https://affpapa.org/nevibecode/skills/caveman-evidence-review.md) — скилл · 104500 установок

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

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