Skip to main content
affpapa.org
RU EN
skill CX Codex

convex-seed — Claude Code skill: what it does, how to install

Populates Convex database tables with sample rows or imports external datasets. Useful when preparing dev environments without manual data entry.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓ 
npx skills add convex/agent-skills --skill convex-seed -a claude-code
Open on GitHub

What convex-seed does

This skill guides agents in seeding Convex database tables using either an internalMutation function or the npx convex import command. When generating test fixtures, the agent writes a mutation that validates data against schema validators and executes it via npx convex run. For larger datasets, it shapes raw data to match schemas before running the import.

Seeding logic must remain idempotent. The workflow enforces using upserts or a clear-then-insert pattern so repeated executions do not create duplicate rows. After insertion, the agent verifies final row counts.

Never push secrets or personally identifiable information into shared deployments, as the instructions explicitly prohibit seeding sensitive data outside local setups.

What it helps with

  • insert sample rows into Convex tables using internalMutation
  • bulk import external datasets using npx convex import
  • make fixture seeding idempotent using clear-then-insert or upserts
  • validate inserted row counts against table schemas

Example prompts for the agent

  • Create an internalMutation to seed sample users into Convex and run it
  • Format data.json to match our schema and import it with npx convex import
  • Make the product table seed function idempotent and check row counts

How to install convex-seed

1Skills CLI (Vercel)

npx skills add convex/agent-skills --skill convex-seed -a claude-code

2Manually: put the files in place

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

Copy the whole skill folder; for one project use .claude/skills/convex-seed/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about convex-seed

How to install convex-seed in Claude Code?

Run npx skills add convex/agent-skills --skill convex-seed -a claude-code in your terminal. This registers the skill workflow for Claude Code.

What does convex-seed do?

It provides workflows for populating Convex tables with test fixtures via internalMutation or importing formatted data matching database validators.

How does convex-seed handle duplicate data?

It enforces idempotency by requiring mutations to perform upserts or clear tables before inserting, followed by row count verification.

Source text

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

Similar skills

Everything for Backend and APIs →
db-seed jezweb Generates database seed scripts with realistic sample data by inspecting Drizzle schemas, Prisma models, or SQL migrations. CX Codex +1 981installs convex waynesutton Routes Convex backend tasks to dedicated builder skills and enforces global rules for queries, mutations, and schemas. Useful as the starting point for any Convex project. CX Codex +1 5,700installs convex-best-practices waynesutton Guides your agent through production Convex patterns, from index design to OCC conflict prevention. Essential for clean mutations, schema validation, and fast queries. CX Codex +1 3,900installs prisma-client-api prisma Complete Prisma Client API reference for database queries, CRUD operations, and filtering. Triggers on findMany, create, update, delete, and $transaction. CX Codex +1 391,400installs prisma-cli prisma Prisma ORM 7 CLI reference for AI agents. Guides client generation, schema migrations, and local database workflows while preventing accidental data loss. CX Codex +1 388,700installs neon-postgres neondatabase This skill guides agents through Neon Postgres connections, schema changes, branching, and database checks. Use it when working with an existing schema or DATABASE_URL. CX Codex +1 281,100installs

From the same set32

convex-add Adds hosting or another backend capability to the current Convex app. Use it when you want an agent to locate and wire a requested component. CX Codex +1 35,900installs convex-advisor Reads a Convex deployment's 72h insights, root-causes each event in code, and reports fixes ranked by severity. CX Codex +1 35,900installs convex-crons Adds recurring scheduled jobs to Convex applications. Useful when you need to schedule backend maintenance and periodic cleanups. CX Codex +1 36,000installs convex-env This skill sets and wires Convex deployment environment variables and secrets. Use it when actions need deployment-specific values without putting secrets in code. CX Codex +1 36,000installs convex-verify convex-verify tests a Convex feature with seeded data, multiple mocked identities, and negative authorization checks. Use it for a specific feature you have built or changed. CX Codex +1 35,800installs convex-monitor This skill blocks on the next event in a Convex app — a dev error, a prod error or a feature request — and hands it to the agent. CX Codex +1 35,800installs convex-billing Adds Stripe payments and subscriptions to a Convex app using @convex-dev/stripe with checkout sessions, webhooks, and subscription gating. CX Codex +1 35,800installs convex-domains Walks your agent through DNS records at your registrar, attaching the domain to a Convex app, and rebinding the auth origin. CX Codex +1 35,800installs

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor