convex-seed

get-convex/agent-skills/convex-seed

This skill enables seeding or importing data into the Convex database. It supports two approaches: writing a re-runnable internalMutation function to insert sample rows, or using the `npx convex import` command for bulk imports. The workflow involves: for fixtures, write an internalMutation that inserts sample rows and run it with `npx convex run`; for bulk import, shape the data to match the schema and use `npx convex import`; make seeding idempotent (clear-then-insert or upsert) so re-running is safe; and verify row counts. When using this skill, seeding must be done via internalMutation or convex import, ensuring data matches validators. Seeding must be idempotent, and never seed secrets or PII into a shared deployment.

Installationen · 493Quelle ansehen

Installation

npx skills add https://github.com/get-convex/agent-skills --skill convex-seed

Skill-Dateien

SKILL.md

Zuletzt synchronisiert · 29.08.2026

SKILL.md›

---
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.