AutoGineer
Generated banner for Convex Seed
Generated logo for Convex Seed

Convex Seed

ConvexOfficialPublished by Convex

  • Skill
  • Tool integration
  • Software development
  • Apache-2.0
  • No issues found
Download ZIP

From the author

Seed or import data into the Convex database.
— the description by Convex

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

This skill provides a structured approach to seeding and importing data into a Convex database. It outlines two primary methods: using re-runnable internal mutations for fixtures or utilizing the command-line import tool for bulk data. The guide emphasizes the importance of schema alignment, idempotency to ensure safe re-execution, and data security by prohibiting the inclusion of secrets or PII in shared environments.

What it does

  • Provides a procedure for creating sample data fixtures using internal mutations.
  • Explains how to perform bulk data imports matching the database schema.
  • Encourages the development of idempotent seeding scripts.
  • Outlines verification steps for confirming data population.
  • Sets safety standards for handling sensitive information during the seeding process.

When to use it

  • When you need to populate a development or staging database with initial sample data.
  • When migrating or bulk-loading existing datasets into a Convex application.
  • When setting up automated testing environments that require consistent database states.
  • When you need to reset or refresh database tables safely without causing conflicts.

Advantages

  • Ensures data consistency by enforcing schema validation during imports.
  • Promotes safe development practices through idempotent seeding patterns.
  • Reduces manual effort for database setup and environment configuration.
  • Prevents accidental exposure of sensitive data in shared deployments.

Usage examples

“How do I seed my Convex database with initial test data?”
The agent will guide you to write an internalMutation that inserts your sample rows and execute it using the appropriate command-line tool.
“What is the best way to bulk import data into Convex?”
The agent will explain how to shape your data to match your schema and use the import command to populate your tables.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/convex/convex-seed/download

  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip convex-seed.zip -d .agents/skills

Documentation by Convex

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

Files

SKILL.md

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

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs Node.js

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Convex
Publisher
Convex (Official)
Source
convex/agent-skills · skills/convex-seed · commit f60629d
Licence
Apache License 2.0 (redistribution allowed)
  • LICENSE (added by AutoGineer from LICENSE)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Convex.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download convex-seed.zip