seed-data

Generates realistic multi-tier seed data for development, testing, demo, and stress environments.

4|Updated Mar 14, 2026
One-click install
npx skills add https://github.com/VoxTechnologies/transmute-framework --skill seed-data-voxtechnologies
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: seed-data
Source: https://github.com/VoxTechnologies/transmute-framework/tree/main/skills/seed-data
Command: npx skills add https://github.com/VoxTechnologies/transmute-framework --skill seed-data-voxtechnologies

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Applications need realistic, referentially intact test data across environments, but hand-writing seed scripts often produces foreign key failures, identical timestamps, business rule violations, and non-idempotent runs. ## Core Features & Use Cases - Multi-Tier Data Generation: Produces dev, test, demo, stress, and empty-state data tiers covering every table in the schema, including persona accounts, edge cases, and soft-deleted records. - Multi-Agent Orchestration: Coordinates a lead agent plus three specialized teammates (core, feature, edge-case seeders) with a shared ID registry and synchronization protocol for referential integrity. - Integrity Verification & Gating: Ships a verify-integrity script checking foreign keys, orphaned records, and soft-delete filtering, plus an audit report with a PASS/CONDITIONAL PASS/FAIL gate decision. - Use Case: After your schema is finalized, ask the agent to populate the database — it creates seed scripts, package.json commands (seed:dev, seed:test, seed:demo, seed:stress, seed:reset), and a full audit report. ## Quick Start Ask the agent to generate seed data and populate the database for all environments after your implementation completeness audit has passed.

Frequently Asked Questions about seed-data

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

FAQPage Schema
How do I generate realistic seed data for my database?

Run this skill after your schema is finalized. It analyzes your data model, PRD personas, and business rules, then generates tiered seed scripts (dev, test, demo, stress, empty-state) that insert data through backend mutation functions while respecting all validators.

How to create test data with valid foreign key relationships?

The skill uses a shared .seed-ids.json registry: a core seeder creates foundational entities first and writes their database IDs, then feature and edge-case seeders read those IDs to create dependent records. IDs are never hardcoded.

Does this seed data approach work with databases other than Convex?

Yes. The examples use Convex plus Next.js, but the skill instructs adaptation to any stack defined in tech-stack.md, mapping Convex mutations to your backend's mutation functions and adjusting environment detection accordingly.

Why do seed scripts fail when run twice?

Non-idempotent seeds create duplicate records on re-runs. This skill requires upsert logic using natural unique keys, or a documented seed:reset command that clears all tables before re-seeding.

Can seed users log in when using an external auth provider?

Only if users are created through the auth provider's API. The skill uses a decision tree: use the provider SDK if available, otherwise document manual setup steps in seed/MANUAL_SETUP.md with alternative test credentials.