excalidash-database-dataflow

Generate and validate ER schema diagrams and data-flow diagrams in Excalidraw via MCP tools.

2|Updated Jun 17, 2026
One-click install
npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-database-dataflow-gabedsam01
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: excalidash-database-dataflow
Source: https://github.com/gabedsam01/excalidash-v2/tree/main/skills/excalidash/excalidash-database-dataflow
Command: npx skills add https://github.com/gabedsam01/excalidash-v2 --skill excalidash-database-dataflow-gabedsam01

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Drawing accurate database ER diagrams or data-flow diagrams by hand is slow and error-prone: foreign keys dangle, cardinality goes unmarked, and processes end up with no inputs or outputs. This Skill produces a validated ER or DFD diagram in Excalidraw, enforcing referential integrity, flow conservation, and a minimum quality score before saving. ## Core Features & Use Cases - ER diagram generation: Renders each table as a card with columns, PK/FK/UK markers, and crow's-foot or Chen cardinality on relation arrows, routing many-to-many relations through explicit junction tables. - Data-flow diagram generation: Places external entities, processes, and cylinder-shaped data stores connected by labelled data flows, validating that every process has at least one input and one output. - Reverse engineering from code: Derives tables, columns, and foreign keys from migrations, ORM models, or Prisma schemas via repository analysis. - Quality loop: Runs lint, score, repair, polish, and architecture validation until the drawing scores at least 95 with zero hard blockers, then saves, versions, and exports to SVG/PNG. - Use Case: Ask to reverse-engineer a Prisma schema into an ER diagram; the Skill builds the table cards, flags any FK missing an index, redacts database connection strings, and exports a clean diagram. ## Quick Start Ask the agent to draw the ER diagram for your orders service with users, orders, products, and an order_items junction table, marking PKs, FKs, and cardinality.

Frequently Asked Questions about excalidash-database-dataflow

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

FAQPage Schema
How do I generate an ER diagram from my database schema?

Describe your tables with columns and key markers (PK, FK, UK) plus relation cardinalities, and the Skill creates the diagram with create_diagram_from_prompt using diagramType er. It validates that every foreign key targets a real primary key before saving.

How to create a data-flow diagram with Excalidraw?

List your external entities, processes, data stores, and the named data flows between them. The Skill builds a level-0 or level-1 DFD with cylinder store symbols and validates that every process has at least one input and one output flow.

Can I reverse-engineer an ER diagram from a Prisma schema or migrations?

Yes. The Skill scans for CREATE TABLE statements, ORM annotations, Prisma schemas, and migration files, assembles them into a structured analysis object, and calls create_from_repo_analysis to derive tables, columns, and foreign key relations.

When should I not use this diagramming skill?

Do not use it for application or service topology, which belongs to a C4 container diagram, or for pub-sub broker topology, which belongs to an event-driven diagram. It is scoped to tables, columns, relations, and data flows only.

Does the skill handle database connection strings safely?

Yes. Connection strings like postgres://user:password@host/db are redacted to typed placeholders such as [REDACTED_DATABASE_URL] before any tool call, and the exported drawing is re-scanned for leaked credentials.

Why does my ER diagram fail validation?

Common failures are a dangling foreign key pointing to a nonexistent table, a many-to-many relation drawn without a junction table, or a relation arrow missing cardinality. The repair loop fixes these and re-validates until the score reaches 95.