# pocketbase-best-practices

Скилл с 64 правилами разработки на PocketBase: схемы коллекций, API-правила, аутентификация, запросы и деплой. Пригодится, когда агент пишет бэкенд и легко ошибается в доступах.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 855 установок · ★ 13
- Автор: community
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/greendesertsnow/pocketbase-skills/tree/HEAD/skills/pocketbase-best-practices/SKILL.md
- Обновлён: 2026-08-23
- HTML: https://affpapa.org/nevibecode/skills/pocketbase-best-practices

## Что делает

Скилл даёт агенту набор правил по девяти категориям: проектирование коллекций, API-правила и безопасность, аутентификация, работа с SDK, производительность запросов, realtime, файлы, продакшен и серверные расширения на Go и JSVM. У каждого правила есть уровень влияния — от Critical до Low, и пример неправильного кода рядом с правильным. Когда правила конфликтуют, побеждает более высокий уровень.

Покрытие рассчитано на PocketBase v0.36 и новее, актуально по v0.40 и JS SDK v0.28. Внутри разобраны типичные промахи агентов: пустые API-правила, из-за которых данные утекают наружу, запросы без индексов, N+1 при expand, сломанные потоки входа и утечки серверных хендлов. Отдельно про OAuth2 — нужна версия не ниже v0.38.2, до неё был баг с перехватом привязки аккаунтов. Это повод проверить свою версию, если вход через провайдеров уже настроен.

Установка идёт через `npx skills add` с указанием агента, файл скилла кладётся в каталог конкретной платформы. Скилл совместим с любым агентом, но пути и команды установки у Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode свои.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install greendesertsnow/pocketbase-skills pocketbase-best-practices
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- задать API-правила так, чтобы данные не утекали наружу
- выбрать тип поля и связи вместо ручных строк с ID
- убрать N+1 запросы через expand и выборку полей
- настроить вход по паролю, OAuth2, OTP и MFA без дыр
- подготовить бэкенд к продакшену: бэкапы, лимиты, доступ суперпользователя

## Примеры запросов агенту
- Проверь мои API-правила в PocketBase по скиллу pocketbase-best-practices
- Спроектируй коллекции для задач и комментариев, следуя pocketbase-best-practices
- Почему у меня N+1 при expand? Разбери по pocketbase-best-practices

## Похожие
- [backend-security-coder](https://affpapa.org/nevibecode/skills/backend-security-coder.md) — скилл · 1000 установок
- [api-auth-key-management](https://affpapa.org/nevibecode/skills/api-auth-key-management.md) — скилл · 7800 установок
- [convex-security-check](https://affpapa.org/nevibecode/skills/convex-security-check.md) — скилл · 2700 установок
- [vtex-io-auth-tokens-and-context](https://affpapa.org/nevibecode/skills/vtex-io-auth-tokens-and-context.md) — скилл · 1100 установок
- [replica-backend](https://affpapa.org/nevibecode/skills/replica-backend.md) — скилл · 613 установок
- [oauth2-provider-design](https://affpapa.org/nevibecode/skills/oauth2-provider-design.md) — скилл · 7800 установок

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

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