# local-first

Скилл local-first помогает решить, нужна ли веб-приложению локальная база с синхронизацией, и выбрать движок и стратегию разрешения конфликтов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 173 установки · ★ 29 у репозитория
- Автор: oakoss
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/oakoss/agent-skills/tree/HEAD/skills/local-first/SKILL.md
- Обновлён: 2026-08-17
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/local-first

## Что делает

Скилл даёт агенту рамку для выбора архитектуры веб-приложения. Внутри таблица решений: серверная схема, local-first или гибрид, путь чтения и записи, движок синхронизации, хранилище на клиенте, разрешение конфликтов. Отдельная таблица собирает типичные ошибки — например, local-first ради простого CRUD или выбор движка до того, как описана модель данных.

Дальше идут справочники: паттерны архитектуры, сравнение движков (ElectricSQL, Zero, PowerSync, Replicache, LiveStore, Triplit), варианты клиентского хранилища (IndexedDB, OPFS, SQLite WASM, PGlite), стратегии конфликтов, офлайн-паттерны, миграции схемы, шифрование и гайд по переходу с серверной схемы. Настройку ElectricSQL, WebTransport и деталей CRDT он передаёт скиллам `electricsql`, `realtime-sync`, `tanstack-db` и `tanstack-start`, если те установлены.

Слэш-команды нет: в файле стоит `user-invocable: false`, поэтому модель подхватывает скилл сама, когда разговор заходит о хранилище или синхронизации. CRDT на каждое поле — лишняя машинерия, для большинства полей хватает LWW или победы сервера. Если сеть стабильна и запросы простые, серверная схема обойдётся дешевле.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill local-first -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill local-first -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install oakoss/agent-skills skills/local-first
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add oakoss/agent-skills --skill local-first -a opencode
```

### Claude.ai

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

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

## Когда брать
- решить, тянуть ли приложение в local-first или остаться на серверной схеме
- выбрать движок синхронизации под Postgres
- сравнить IndexedDB, OPFS и PGlite по ёмкости и сложности запросов
- продумать разрешение конфликтов до того, как они всплывут в проде
- расписать миграции локальной схемы без потери данных

## Примеры запросов агенту
- Мы делаем канбан с офлайн-режимом: стоит ли уходить в local-first и какой движок синхронизации взять под Postgres?
- Сравни IndexedDB и PGlite для хранения заявок на клиенте, если нужны сложные запросы.
- Какая стратегия конфликтов подойдёт для полей карточки товара: LWW или CRDT?

## Похожие
- [linear-local-first-architecture](https://affpapa.org/nevibecode/skills/linear-local-first-architecture.md) — скилл · 201 установка
- [remem-mcp — Local-first MCP Memory + CodeGraph + Wiki](https://affpapa.org/nevibecode/mcp/remem-mcp-local-first-mcp-memory-codegraph-wiki.md) — MCP-сервер · ★ 9 у репозитория
- [progressive-web-app](https://affpapa.org/nevibecode/skills/aj-geddes-progressive-web-app.md) — скилл · 531 установка
- [mnema](https://affpapa.org/nevibecode/mcp/mnema.md) — MCP-сервер
- [Graphiti Local](https://affpapa.org/nevibecode/mcp/graphiti-local.md) — MCP-сервер · ★ 5 у репозитория
- [capacitor-offline-first](https://affpapa.org/nevibecode/skills/capacitor-offline-first.md) — скилл · 1100 установок

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

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

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