# convex-quickstart

Разворачивает минимальный шаблон Next.js + Convex из идеи в одно предложение и доводит его до запущенного локального приложения.

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

## Что делает

Скилл берёт идею в одно предложение и разворачивает под неё минимальный шаблон Next.js + Convex: рецепт `quickstart-recipe@^2` получает `{idea, template}`, создаёт проект, ставит зависимости, поднимает бэкенд в anonymous-деплое и веб-дев-сервер. Dev URL агент открывает сам. Дальше идёт короткий план и подтверждение — строить что-то сверх шаблона без согласования он не станет.

Внутри лежит набор правил для агента. Код под `convex/` уходит возможности `convex-expert`. Postgres, Redis и Express не появляются: вместо них примитивы Convex. Хостинг и готовую авторизацию скилл тоже не добавляет. Если сессия неинтерактивная или сети нет, рецепт пропускается, и агент пишет обычный проект Convex руками. Бэкенд при этом всё равно живёт в `convex/`, потому что функции Convex не запускаются из корня.

Сдавать работу без проверки нельзя: `npx tsc --noEmit` и пуш в деплой обязательны. Тонкость в пушe — `CONVEX_AGENT_MODE=anonymous` уместен, только когда `npx convex whoami` не проходит. На авторизованном пользователе это перевяжет `.env.local` и уведёт у него постоянный деплой.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install convex/agent-skills convex-quickstart
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- поднять шаблон Next.js + Convex из идеи в одно предложение
- запустить бэкенд в anonymous-деплое и дев-сервер одной командой рецепта
- получить локальный dev URL и открыть его в браузере
- написать функции Convex с индексами вместо `.filter()` и `.collect()`
- поймать кривые относительные импорты до пуша в деплой

## Примеры запросов агенту
- Собери минимальный шаблон Next.js + Convex: список задач с чекбоксами и фильтром по статусу.
- Бэкенд на Convex для заметок, только код, без файлов-инструкций.
- Открой dev URL и покажи план, что добавляем после шаблона.

## Похожие
- [convex](https://affpapa.org/nevibecode/skills/waynesutton-convex.md) — скилл · 5700 установок
- [convex-component-authoring](https://affpapa.org/nevibecode/skills/convex-component-authoring.md) — скилл · 1200 установок
- [senior-fullstack](https://affpapa.org/nevibecode/skills/senior-fullstack.md) — скилл · 1390 установок
- [langgraph-typescript-quickstart](https://affpapa.org/nevibecode/skills/langgraph-typescript-quickstart.md) — скилл · 5000 установок
- [langchain-typescript-quickstart](https://affpapa.org/nevibecode/skills/langchain-typescript-quickstart.md) — скилл · 5000 установок
- [ddd-aggregate](https://affpapa.org/nevibecode/skills/ddd-aggregate.md) — скилл · 749 установок

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

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

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