# turso-db

Скилл с документацией и рецептами для встроенной SQL-базы Turso: подсказывает агенту актуальные SDK вместо устаревшего libSQL.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 513 установок · ★ 30
- Автор: tursodatabase
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/tursodatabase/agent-skills/tree/HEAD/skills/turso-db/SKILL.md
- Обновлён: 2026-07-22
- HTML: https://affpapa.org/nevibecode/skills/turso-db

## Что делает

Turso — встроенная SQL-база, совместимая с SQLite, написанная на Rust. Скилл даёт агенту справочники по SDK и готовые рецепты: векторный поиск, полнотекстовый поиск, CDC, MVCC, шифрование, удалённая синхронизация. Внутри — дерево решений по фичам и по языкам, таблица установки пакетов и краткие справки по CLI и SQL.

Пакеты лежат под именами `@tursodatabase`: `@tursodatabase/database` для Node.js, `@tursodatabase/serverless` для edge-функций, `@tursodatabase/database-wasm` для браузера, `@tursodatabase/sync-react-native` для мобильных. Есть также `turso` для Rust, `pyturso` для Python и `tursogo` для Go. Скилл прямо запрещает искать в вебе «libsql» и «@libsql/client» — это старые имена, и выдача приведёт к устаревшим API.

База в статусе беты: часть возможностей SQLite ещё не реализована. Файл базы открывает только один процесс за раз, таблицы без rowid не поддерживаются, `VACUUM` не работает, кодировка только UTF-8. Полнотекстовый поиск требует сборки с фичей `fts`, шифрование включается флагом `--experimental-encryption`, а MVCC помечен как экспериментальный и не готов к продакшену. Если в проекте уже есть код на `@libsql/client`, скилл поможет переписать его на новые пакеты.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tursodatabase/agent-skills --skill turso-db -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tursodatabase/agent-skills --skill turso-db -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tursodatabase/agent-skills --skill turso-db -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install tursodatabase/agent-skills turso-db
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add tursodatabase/agent-skills --skill turso-db -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/tursodatabase/agent-skills --path skills/turso-db
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add tursodatabase/agent-skills --skill turso-db -a opencode
```

### Claude.ai

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

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

## Когда брать
- выбрать нужный SDK Turso под Node.js, браузер или React Native
- переписать код с устаревшего `@libsql/client` на `@tursodatabase`
- поднять векторный поиск по эмбеддингам
- включить полнотекстовый поиск с ранжированием BM25
- настроить синхронизацию локальной базы с удалённой

## Примеры запросов агенту
- Подключи Turso к проекту на Node.js через `@tursodatabase/database`
- Сделай таблицу с векторным поиском по эмбеддингам, расстояние по возрастанию
- Покажи, как включить полнотекстовый поиск и ранжирование BM25

## Похожие
- [mcp-turso-cloud](https://affpapa.org/nevibecode/mcp/mcp-turso-cloud.md) — MCP-сервер · ★ 18
- [pgmicro-postgres-sqlite](https://affpapa.org/nevibecode/skills/pgmicro-postgres-sqlite.md) — скилл · 811 установок
- [mvcc](https://affpapa.org/nevibecode/skills/mvcc.md) — скилл · 1200 установок
- [transaction-correctness](https://affpapa.org/nevibecode/skills/transaction-correctness.md) — скилл · 1200 установок
- [vector-search](https://affpapa.org/nevibecode/skills/vector-search.md) — скилл · 751 установка
- [m11-ecosystem](https://affpapa.org/nevibecode/skills/m11-ecosystem.md) — скилл · 3300 установок

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

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

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