Relational Mapper Skill

Detect relationships and generate synthetic data for multi-table relational databases.

Updated Oct 29, 2025
One-click install
npx skills add https://github.com/ksmuvva/Synthetic-data-generator --skill relational-mapper-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Relational Mapper Skill
Source: https://github.com/ksmuvva/Synthetic-data-generator/tree/main/.claude/skills/relational-mapper
Command: npx skills add https://github.com/ksmuvva/Synthetic-data-generator --skill relational-mapper-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the complex process of detecting relationships between multiple data tables and generating synthetic data that adheres to these relationships and maintains referential integrity.

Core Features & Use Cases

  • Relationship Detection: Automatically identifies primary keys, foreign keys, and various relationship types (1:1, 1:N, N:M).
  • Referential Integrity: Ensures generated data respects foreign key constraints, preventing orphaned records.
  • Use Case: Generate a realistic e-commerce database with customers, orders, and order items, ensuring each order is linked to a valid customer and each order item to a valid order.

Quick Start

Use the relational mapper skill to analyze the schema and generate 1000 customer records, 5000 orders, and 15000 order items, maintaining referential integrity.

Frequently Asked Questions about Relational Mapper Skill

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

FAQPage Schema
How do I generate synthetic data for a multi-table relational database?

To generate synthetic data for a relational database, you must map schema relationships and enforce referential integrity. This skill automates primary and foreign key detection, cardinality analysis, and generation order calculation to produce valid records across linked tables.

How do I maintain referential integrity when generating mock database records?

Maintaining referential integrity during data generation requires enforcing foreign key constraints to prevent orphaned records. This skill ensures generated synthetic data respects detected schema mappings, keeping child table records linked to valid parent table entries.

Can I automatically detect foreign keys and relationship types in an existing database schema?

Yes, you can automatically detect foreign keys and relationship types. The skill analyzes multi-table schemas to identify 1:1, 1:N, and N:M relationships, mapping complex structures before generating synthetic data that adheres to the underlying constraints.

What is the best way to populate an e-commerce database with synthetic customers, orders, and items?

The best way to populate relational databases like e-commerce schemas is calculating generation order based on detected dependencies. This skill generates the correct volume of customers, orders, and items while automatically linking foreign keys to maintain referential integrity.

How does schema mapping handle complex table structures during synthetic data generation?

Schema mapping handles complex structures by analyzing cardinality and relationship types across multiple tables. The skill calculates the correct generation order based on detected foreign keys, ensuring synthetic data accurately reflects intricate relational database dependencies.