# Seed

> Seed/import data into a Convex app (fixtures via internalMutation or convex import). TRIGGER on a seed/sample-data/import request.

- Skill: `get-convex/seed-2` (Agent Skill)
- Install (CLI): `npx get-skill add get-convex/seed-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/get-convex/seed-2/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: Apache-2.0
- Author: get-convex (https://skillmd.com/u/get-convex)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/get-convex/seed-2

---


# Seed / import data

Populate tables via an internalMutation seed function (re-runnable) or `npx convex import`, matching the schema.

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

