convex-test — скилл для Claude Code: что делает и как установить
Помогает генерировать детерминированные тесты для функций Convex с помощью convex-test и vitest. Проверяет запросы, мутации и авторизацию без запуска реального бэкенда.
npx skills add convex/agent-skills --skill convex-test -a claude-codeЧто делает convex-test
Скилл инструктирует агента, как создавать тесты для функций Convex на базе фреймворка vitest. Всё окружение поднимается в оперативной памяти через convex-test, поэтому реальный деплой и доступ к сети для проверок не нужны.
Генерация строится вокруг вызова convexTest(schema). Тест заполняет базу через t.run, выполняет t.query или t.mutation и проверяет полученный результат. Кроме позитивных сценариев инструкция требует обязательно закрывать пути ошибок, проверять авторизацию через withIdentity и дожидаться отложенных задач с помощью t.finishInProgressScheduledFunctions.
Тесты требуют предварительной установки пакетов convex-test и vitest в проект.
Какие задачи решает
- написать тесты vitest для мутаций и запросов Convex
- проверить логику авторизации функций с помощью withIdentity
- протестировать выполнение запланированных задач без ожидания таймеров
- смоделировать ошибки и граничные условия во встроенной базе
Примеры запросов агенту
- Напиши тесты vitest для мутации создания пользователя с проверкой auth через withIdentity
- Покрой тестами convex-test запланированные функции и дождись их через finishInProgressScheduledFunctions
- Сгенерируй тесты для convex/schema.ts с проверкой индексов и ошибочных аргументов
Как установить convex-test
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-test -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-test/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-test/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-test -a codex2Вручную: положить файлы
.agents/skills/convex-test/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-test -a cursor2Вручную: положить файлы
.cursor/skills/convex-test/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-test2Вручную: положить файлы
.github/skills/convex-test/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-test -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-testВручную: положить файлы
.devin/skills/convex-test/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-test -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-test
Как установить convex-test в Claude Code?
Выполните команду npx skills add convex/agent-skills --skill convex-test -a claude-code в терминале проекта.
Что делает скилл convex-test?
Он направляет ассистента при составлении детерминированных тестов для функций Convex. Тесты проверяют аргументы, возвращаемые значения, мутации, индексы и сценарии с авторизацией.
Нужен ли реальный сервер Convex для запуска тестов?
Нет, тесты запускаются в памяти через библиотеку convex-test. Доступ к сети или активному деплою не требуется.
Исходный текст
SKILL.md · Apache-2.0
--- name: convex-test description: "Generate convex-test tests for the app's Convex functions." --- <!-- GENERATED from convex-agents content/capabilities/test.json — do not edit by hand. --> # Generate Convex tests Use convex-test + vitest to test functions against an in-memory backend: args/returns, auth paths, indexes, and scheduled functions. ## Workflow 1. Install convex-test + vitest. 2. Write tests using convexTest(schema): seed via t.run, call t.query/t.mutation, assert. 3. Cover auth (withIdentity), error paths, and scheduled functions (t.finishInProgressScheduledFunctions). 4. Run vitest; keep tests deterministic. ## Rules - Use convex-test (in-memory), not a live deployment. - Cover auth + error paths, not just the happy path. - Keep tests deterministic (no real time/network).
© convex · Apache-2.0 · convex/agent-skills
