# convex

Маршрутизирует задачи по Convex к специализированным скиллам и задаёт базовые правила разработки бэкенда. Пригодится на старте любого проекта с Convex.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 5700 установок · ★ 405
- Автор: waynesutton
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/waynesutton/builder-skills/tree/HEAD/skills/convex/SKILL.md
- Обновлён: 2026-09-28
- HTML: https://affpapa.org/nevibecode/skills/waynesutton-convex

## Что делает

Скилл служит отправной точкой при разработке на Convex. Он сопоставляет задачу с шестнадцатью узкими скиллами вроде `convex-functions`, `convex-schema-validator` или `convex-realtime`. Если точного совпадения нет, агент опирается на общие правила фреймворка.

Инструкции требуют валидаторов `args` и `returns` для каждой функции, включая внутренние. Чтение данных выполняется строго через `withIndex`, потому что метод `.filter()` при сканировании таблицы приводит к ошибкам на реальных данных. Мутации обязаны быть идемпотентными. Планировщик и крон настраиваются только на функции `internal.*`.

Скилл прямо запрещает трогать директорию `convex/_generated/` и вызывать `Date.now()` внутри запросов. Для локальной работы используется команда `npx convex dev`. При сомнениях в сигнатурах API агент должен сначала выгрузить документацию по адресу `docs.convex.dev/llms.txt`. Это защищает проект от галлюцинаций старых версий.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install waynesutton/builder-skills convex
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- направить задачу к нужному специализированному скиллу Convex
- добавить валидаторы `args` и `returns` во все функции
- заменить сканирование таблицы с `.filter()` на чтение по индексу через `withIndex`
- настроить фоновые задачи через `internal.*` и `crons.cron`

## Примеры запросов агенту
- Помоги настроить схему таблиц и индексы в Convex
- Сделай мутацию для обновления профиля идемпотентной
- Проверь наши функции Convex перед деплоем

## Похожие
- [convex-expert](https://affpapa.org/nevibecode/skills/convex-expert.md) — скилл · 36200 установок
- [convex-create-component](https://affpapa.org/nevibecode/skills/convex-create-component.md) — скилл · 130900 установок
- [appwrite-python](https://affpapa.org/nevibecode/skills/appwrite-python.md) — скилл · 1100 установок
- [firebase](https://affpapa.org/nevibecode/plugins/firebase.md) — плагин · ★ 44635
- [prisma-client-api](https://affpapa.org/nevibecode/skills/prisma-client-api.md) — скилл · 391400 установок

## Другие версии с тем же именем
- [convex · convex](https://affpapa.org/nevibecode/skills/convex.md) — 108000 установок
- [convex · mindrally](https://affpapa.org/nevibecode/skills/mindrally-convex.md) — 651 установка

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

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

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