convex-seed

Seed or import data into a Convex database using internal mutations or bulk import.

9.4k|1.5k|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/openclaw/clawhub --skill convex-seed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convex-seed
Source: https://github.com/openclaw/clawhub/tree/main/.agents/skills/convex-seed
Command: npx skills add https://github.com/openclaw/clawhub --skill convex-seed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Populating a Convex database with initial or test data is error-prone when done manually, and re-running seed scripts can create duplicates or schema mismatches. This Skill provides a repeatable, schema-safe workflow for seeding tables.

Core Features & Use Cases

  • Fixture Seeding via internalMutation: Write a re-runnable internal mutation that inserts sample rows and execute it with npx convex run.
  • Bulk Import: Shape data to match the schema validators and load it with npx convex import.
  • Idempotent Design: Use clear-then-insert or upsert patterns so re-running seeds is safe, then verify row counts.
  • Use Case: When setting up a new Convex deployment for staging, run the seed mutation to populate tables with fixture data, then confirm row counts match expectations before handing off to QA.

Quick Start

Seed my Convex database with sample fixture data using an idempotent internal mutation and verify the row counts.

Frequently Asked Questions about convex-seed

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I seed a Convex database with test data?

Write an internalMutation that inserts sample rows matching your schema validators, then run it with npx convex run. For larger datasets, shape the data to the schema and use npx convex import instead.

How to make Convex seed scripts idempotent?

Use a clear-then-insert or upsert pattern inside the seed mutation so re-running it does not create duplicates. After seeding, verify row counts to confirm the operation succeeded.

When should I use npx convex import instead of a seed mutation?

Use npx convex import for bulk data loading when you have a large dataset already shaped to match the schema. Use an internalMutation seed function for smaller fixture sets that need programmatic logic.

Can I seed production data or credentials into Convex?

No. Never seed secrets or PII into a shared deployment. Seed data should be synthetic fixtures only, keeping sensitive values out of any environment accessible to multiple developers.

Why does my Convex seed fail with validation errors?

Seed inserts fail when the data does not match the schema validators defined for the table. Check that every field type and required property in your fixture rows conforms to the schema before running the mutation.