# surrealdb-expert

Скилл surrealdb-expert помогает проектировать схемы SurrealDB, настраивать графовые связи, писать запросы SurrealQL и защищать данные на уровне строк через TDD.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 276 установок · ★ 48 у репозитория
- Автор: martinholovsky
- Лицензия: Unlicense · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/martinholovsky/claude-skills-generator/tree/HEAD/skills/surrealdb-expert/SKILL.md
- Обновлён: 2025-12-06
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/surrealdb-expert

## Что делает

Скилл задаёт агенту роль разработчика SurrealDB. Он специализируется на многомодельных базах, объединяя документы, связи в графах и временные ряды. В работе упор сделан на запросах SurrealQL, строгой типизации таблиц через `DEFINE TABLE ... SCHEMAFULL` и подписках реального времени через `LIVE` запросы.

Архитектура опирается на принцип разработки через тестирование. Сначала создаётся падающий тест в `pytest` с использованием официального клиента `surrealdb`, затем пишется схема и логика для его прохождения. Скилл учит хешировать пароли встроенной функцией `crypto::argon2::generate` и валидировать входные данные через условия `ASSERT`.

Особое внимание уделено защите данных и известным уязвимостям базы, включая утечки в `LIVE` подписках. Для изоляции записей обязательно настраивается блок `PERMISSIONS` с проверкой `$auth.id`. Без переданного контекста авторизации такие запросы завершатся отказом в доступе.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill surrealdb-expert -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill surrealdb-expert -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill surrealdb-expert -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install martinholovsky/claude-skills-generator skills/surrealdb-expert
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill surrealdb-expert -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/martinholovsky/claude-skills-generator --path skills/surrealdb-expert
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add martinholovsky/claude-skills-generator --skill surrealdb-expert -a opencode
```

### Claude.ai

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

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

## Когда брать
- составить строгую схему `SCHEMAFULL` с валидацией через `ASSERT`
- ограничить доступ к строкам таблицы правилами `PERMISSIONS` на базе `$auth.id`
- построить связи между сущностями графа с помощью `RELATE`
- написать падающие тесты на `pytest` перед проектированием схемы SurrealDB

## Примеры запросов агенту
- Напиши падающий тест на pytest для регистрации пользователя с хешированием пароля через argon2 в SurrealDB.
- Спроектируй схему таблицы user в режиме SCHEMAFULL с правилами доступа для $auth.id.

## Похожие
- [surrealdb-docs](https://affpapa.org/nevibecode/skills/surrealdb-docs.md) — скилл · 273 установки
- [surrealdb-python](https://affpapa.org/nevibecode/skills/surrealdb-python.md) — скилл · 541 установка
- [huawei-cloud-ges-graph](https://affpapa.org/nevibecode/skills/huawei-cloud-ges-graph.md) — скилл · 197 установок
- [amazon-neptune](https://affpapa.org/nevibecode/skills/amazon-neptune.md) — скилл · 2200 установок
- [spring-data-neo4j](https://affpapa.org/nevibecode/skills/spring-data-neo4j.md) — скилл · 4000 установок
- [ax-add-ingest-stage](https://affpapa.org/nevibecode/skills/ax-add-ingest-stage.md) — скилл · ★ 124 у репозитория

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

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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