К основному содержанию
скилл CX Codex

convex-seed — скилл для Claude Code: что делает и как установить

Заполняет таблицы базы данных Convex тестовыми строками или импортирует внешние данные. Помогает настроить окружение для разработки без ручного ввода.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add convex/agent-skills --skill convex-seed -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/convex-seed/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/convex-seed/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Всё по теме «Бэкенд и API» →
db-seed jezweb Генерирует скрипты сидирования базы данных с правдоподобными тестовыми записями на основе схем Drizzle, Prisma или файлов SQL-миграций. CX Codex +1 981установок convex waynesutton Маршрутизирует задачи по Convex к специализированным скиллам и задаёт базовые правила разработки бэкенда. Пригодится на старте любого проекта с Convex. CX Codex +1 5 700установок convex-best-practices waynesutton Скилл учит агента писать надёжный бэкенд на Convex без конфликтов записи OCC. Помогает настроить валидаторы, индексы и правила @convex-dev/eslint-plugin. CX Codex +1 3 900установок prisma-client-api prisma Справочник по Prisma Client API для написания запросов к БД, CRUD-операций и фильтрации. Срабатывает на упоминания findMany, create, update, delete и транзакций. CX Codex +1 391 400установок prisma-cli prisma Справочник по командам Prisma ORM 7 для ИИ-агентов. Помогает запускать миграции, генерировать клиент и безопасно работать с базой данных без случайного сброса данных. CX Codex +1 388 700установок neon-postgres neondatabase Скилл помогает агенту работать с базой Postgres на Neon: выбирать подключение, вести миграции и проверять состояние базы. Пригодится для задач с существующей схемой или DATABASE_URL. CX Codex +1 281 100установок

Из того же набора32

convex-add Добавляет в текущее приложение Convex хостинг или другую серверную возможность. Пригодится, когда нужно подключить компонент по запросу через агента. CX Codex +1 35 900установок convex-advisor Читает 72-часовые инсайты деплоя Convex, находит причину каждого события в коде и отдаёт отчёт с исправлениями. CX Codex +1 35 900установок convex-crons Добавляет периодические фоновые задачи через crons в приложение на Convex. Пригодится, когда нужно настроить регулярное обслуживание базы или очистку данных. CX Codex +1 36 000установок convex-env Скилл настраивает переменные окружения и секреты Convex для приложения. Пригодится, когда значения нужно передавать в deployment и читать в actions. CX Codex +1 36 000установок convex-verify Скилл проверяет Convex-функции через реальные сценарии: создаёт данные, меняет пользователей и ловит ошибки авторизации. Нужен для проверки конкретной готовой функции. CX Codex +1 35 800установок convex-monitor Скилл блокируется на следующем событии в приложении Convex — ошибке разработки, ошибке прода или запросе фичи — и передаёт его агенту. CX Codex +1 35 800установок convex-billing Подключает подписки Stripe к приложению на Convex через компонент @convex-dev/stripe: настраивает сессии оплаты, вебхуки и серверную проверку статуса. CX Codex +1 35 800установок convex-domains Ведёт агента по шагам: DNS-записи у вашего регистратора, привязка домена к приложению Convex и перепривязка auth-origin. CX Codex +1 35 800установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой