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.