reversa-data-master

Generate ERD and markdown documentation from legacy database artifacts.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-data-master-afsjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reversa-data-master
Source: https://github.com/afsjr/secretaria_escola_csm/tree/main/.agents/skills/reversa-data-master
Command: npx skills add https://github.com/afsjr/secretaria_escola_csm --skill reversa-data-master-afsjr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill turns an undocumented legacy database into a complete, searchable data reference, reducing uncertainty and rework when you need to migrate schemas, build DDL/migrations, or implement ORM models.

Core Features & Use Cases

  • Full database documentation: Produce an inventory of tables/collections and describe their purpose, columns, data types, nullability, defaults, keys, indexes, and constraints.
  • Relationship mapping: Generate detailed relationship documentation including cardinalities, join tables, and any polymorphic patterns.
  • Database logic extraction: Capture business rules expressed in the database via triggers, stored procedures/functions, views, and check constraints when available.
  • ERD generation: Create a complete ERD in Mermaid, with partial ERDs per domain when the database is large.
  • Use case: When DDL, migrations, or ORM models exist, use this output to accurately recreate the schema during refactors or to plan migrations without breaking data integrity.

Quick Start

Run the reversa-data-master skill to generate ERD, data dictionary, relationships, and business rules artifacts into the output folder defined by .reversa/state.json (field output_folder).

Frequently Asked Questions about reversa-data-master

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

FAQPage Schema
How do I document a legacy database schema with an ERD and data dictionary?

To document a legacy database schema, you can reverse-engineer existing DDL, migrations, or ORM models to generate a complete data dictionary, relationship mappings, and a Mermaid ERD. This process captures tables, columns, keys, indexes, and constraints into structured markdown files.

Can I reverse-engineer database triggers and stored procedures into documentation?

Yes, database logic extraction captures business rules expressed through triggers, stored procedures, functions, views, and check constraints. It analyzes available database inspection artifacts to document these audit-ready business rules alongside the structural schema.

What is the best way to map table relationships and cardinalities for schema migration?

Mapping table relationships for migration is best achieved by reverse-engineering DDL or ORM models to document cardinalities, join tables, and polymorphic patterns. This generates detailed relationship documentation and partial ERDs per domain for large databases.

How do I generate Mermaid ERDs from existing DDL or ORM models?

You can generate Mermaid ERDs from DDL or ORM models by performing schema reverse engineering. This process analyzes available schema definitions to produce a complete entity-relationship diagram, dividing into partial ERDs per domain when handling large databases.

Does schema reverse engineering work without direct database access?

Yes, schema reverse engineering works without direct database access by analyzing available DDL scripts, migration files, or ORM model definitions. It uses these static inspection artifacts to extract table structures, keys, indexes, and relationship mappings.

What are the limitations of reverse-engineering a database from DDL and migrations?

Reverse-engineering from DDL and migrations is limited by the completeness of the available artifacts. It requires full coverage of DDL, migration files, or ORM models to accurately extract constraints, triggers, and relationship mappings without missing database-level business rules.