# instantdb

Скилл ведёт агента при сборке приложений на InstantDB: схема, права доступа, запросы, хранилище файлов. Пригодится, когда нужен бэкенд без своего сервера.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1400 установок · ★ 9
- Автор: instantdb
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/instantdb/skills/tree/HEAD/skills/instantdb/SKILL.md
- Обновлён: 2026-06-08
- HTML: https://affpapa.org/nevibecode/skills/instantdb

## Что делает

Скилл превращает агента в старшего фронтенд-инженера со знанием InstantDB. Он помогает собрать рабочее приложение на React, обычном JS или Expo, где бэкендом служит клиентская база Instant с запросами, транзакциями, авторизацией, правами, хранилищем файлов, реальным временем и офлайн-режимом.

Внутри — правила работы с CLI и SDK. Агент смотрит, какой пакетный менеджер в проекте, и ставит нужный SDK: `@instantdb/react`, `@instantdb/core`, `@instantdb/react-native` и другие. Схема и права лежат в `instant.schema.ts` и `instant.perms.ts`, изменения уходят командами `npx instant-cli push schema --yes` и `npx instant-cli push perms --yes`. Для нового приложения есть `npx instant-cli init-without-files --title <APP_NAME>`, он выдаёт app id и admin token.

Дальше начинаются строгости, из-за которых скилл и стоит держать под рукой. Любое поле для фильтра или сортировки обязано быть проиндексировано в схеме, иначе запрос упадёт с ошибкой. Ключи пагинации работают только на верхнем уровне, на вложенных связях — нет. В правах `data.ref` всегда возвращает список, поэтому сравнение с одиночным значением не пройдёт. Заранее понадобится аккаунт InstantDB и вход через `npx instant-cli login`.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install instantdb/skills instantdb
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- поднять бэкенд для React-приложения без своего сервера
- описать схему и вытолкнуть её в облако одной командой
- настроить права доступа к полям и связям
- загрузить картинки через Instant Storage и связать их с записями
- собрать запрос с фильтром, сортировкой и пагинацией без ошибок

## Примеры запросов агенту
- Собери приложение для заметок на React и InstantDB, схему положи в `instant.schema.ts`
- Добавь в схему индекс на `dueDate` и запрос с сортировкой по нему
- Настрой права так, чтобы email видел только владелец записи

## Похожие
- [convex](https://affpapa.org/nevibecode/skills/mindrally-convex.md) — скилл · 651 установка
- [expo-dom](https://affpapa.org/nevibecode/skills/expo-dom.md) — скилл · 21000 установок
- [auditing-performance](https://affpapa.org/nevibecode/skills/auditing-performance.md) — скилл · 476 установок
- [monorepo](https://affpapa.org/nevibecode/skills/monorepo.md) — скилл · 694 установки
- [prisma-client-api](https://affpapa.org/nevibecode/skills/prisma-client-api.md) — скилл · 391400 установок
- [prisma-cli](https://affpapa.org/nevibecode/skills/prisma-cli.md) — скилл · 388700 установок

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