convex-seed — скилл для Claude Code: что делает и как установить
Заполняет таблицы базы данных Convex тестовыми строками или импортирует внешние данные. Помогает настроить окружение для разработки без ручного ввода.
npx skills add convex/agent-skills --skill convex-seed -a claude-codeЧто делает convex-seed
Скилл настраивает наполнение таблиц базы данных Convex через internalMutation или команду npx convex import. Для генерации фикстур агент создаёт внутреннюю мутацию, сверяет типы с валидаторами схемы и запускает её через npx convex run. Если нужно загрузить готовый массив данных, он форматирует файл под схему и вызывает импорт.
Главное требование при подготовке фикстур — идемпотентность. Скрипт должен либо обновлять существующие записи через upsert, либо очищать таблицу перед вставкой, чтобы повторный запуск не плодил дубли. После выполнения обязательно проверяется итоговое количество строк.
Не передавайте персональные данные и секретные ключи в общие базы: правило скилла прямо запрещает загрузку PII на совместные деплои.
Какие задачи решает
- наполнить таблицы Convex тестовыми строками через internalMutation
- импортировать внешние наборы данных командой npx convex import
- сделать сидинг фикстур идемпотентным через upsert или очистку
- проверить соответствие структуры данных валидаторам схемы
Примеры запросов агенту
- Заполни таблицу users в Convex тестовыми профилями через internalMutation
- Подготовь импорт данных из data.json в базу Convex через npx convex import
- Сделай сидинг таблицы продуктов идемпотентным и проверь число строк
Как установить convex-seed
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-seed -a claude-code2Вручную: положить файлы
~/.claude/skills/convex-seed/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/convex-seed/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-seed -a codex2Вручную: положить файлы
.agents/skills/convex-seed/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-seed -a cursor2Вручную: положить файлы
.cursor/skills/convex-seed/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install convex/agent-skills convex-seed2Вручную: положить файлы
.github/skills/convex-seed/SKILL.md1Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-seed -a gemini-cli2Командой платформы
gemini skills install https://github.com/convex/agent-skills --path skills/convex-seedВручную: положить файлы
.devin/skills/convex-seed/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add convex/agent-skills --skill convex-seed -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о convex-seed
Как установить convex-seed в Claude Code?
Выполните команду npx skills add convex/agent-skills --skill convex-seed -a claude-code. Агент получит инструкции по сидингу и импорту данных.
Что делает convex-seed?
Он задаёт правила наполнения базы Convex тестовыми строками через internalMutation или импорта файлов по схеме проекта.
Как скилл предотвращает появление дубликатов при повторном сидинге?
Инструкция требует делать мутации идемпотентными — использовать метод upsert или предварительную очистку таблиц перед вставкой строк.
Исходный текст
SKILL.md · Apache-2.0
--- name: convex-seed description: "Seed or import data into the Convex database." --- <!-- GENERATED from convex-agents content/capabilities/seed.json — do not edit by hand. --> # Seed / import data Populate tables via an internalMutation seed function (re-runnable) or `npx convex import`, matching the schema. ## Workflow 1. For fixtures: write an internalMutation that inserts sample rows; run it with `npx convex run`. 2. For bulk import: shape the data to the schema and use `npx convex import`. 3. Make seeding idempotent (clear-then-insert or upsert) so re-running is safe. 4. Verify row counts. ## Rules - Seed via internalMutation or convex import, matching validators. - Make seeding idempotent. - Never seed secrets/PII into a shared deployment.
© convex · Apache-2.0 · convex/agent-skills