Skip to content
Development
Skill

/erd

Generate ERD .drawio — entities, attributes, 1-1/1-N/N-N relationships, PK/FK. Hand-authored XML with TechSphereX AI palette; complex SQL DDL → /diagram --from-sql.

From plugin
agentic-awesome-kits
1032 skills

Claude Code

$ npx -y skills add KhaiTrang1995/agentic-awesome-kits --skill erd --agent claude-code

SKILL.md

erd.SKILL.md
name: erd
description: Generate ERD .drawio — entities, attributes, 1-1/1-N/N-N relationships, PK/FK. Hand-authored XML with TechSphereX AI palette; complex SQL DDL → /diagram --from-sql.
user-invocable: true
argument-hint: "<entity/relationship description> [--feature slug] [@schema.sql]"

/erd — Entity-Relationship Diagram (draw.io)

When to use

  • Data model for design docs / BA–dev alignment
  • A few–dozens of entities described in words (no SQL importer needed)
  • Need a hand-editable `.drawio` file

**Switch to `/diagram` when:** large SQL DDL file (`sqlerd.py`), auto-layout for dozens of tables, or batch PNG export.

Input examples

/erd Order 1-N OrderLine, Order N-1 Customer, Order 1-1 Payment --feature booking
/erd auth module: User, Role, UserRole (N-N), Permission
/erd @schema.sql   → suggest /diagram --from-sql if >8 tables

Workflow

Phase 1 — Inventory

List:

| Entity | PK | Attributes (short) | Notes | |--------|----|--------------------|-------| | | | | |

Relationships: `A 1—N B`, `A N—N B` (// associative entity if needed).

Missing relationship names / cardinality → ask 1–2 questions; **do not invent** FKs.

Phase 2 — L3 layout preview

Node + edge table (ASCII/table). User reviews before XML.

Phase 3 — Generate XML

Use `@_templates/erd.drawio` as the frame:

  • Entity = rounded rect (or swimlane-style header): **bold entity name** + attr list
  • Mark PK as `PK`; FK as `FK` (text only)
  • Edge: `endArrow=ERoneToMany` / `ERmandOne` / `ERzeroToMany` when appropriate; fallback `endArrow=block` + labels `1` / `N` on the edge
  • Palette: entity fill `#dae8fc`, associative `#fff2cc`, external ref `#f5f5f5` (per conventions)
  • Grid 20; entity box ~200×(40 + 20×attr count)

Phase 4 — L1 → Write

`docs/diagrams/{feature}/erd-{slug}.drawio`

Mandatory rules

  • @.claude/rules/drawio-conventions.md (core shapes, escape XML)
  • @.claude/rules/naming-conventions.md
  • @.claude/rules/approval-gate.md
  • Do not invent columns/relationships; TBD + ask
  • ≤ 15 entities per page — more: split by domain or use `/diagram` + sqlerd/autolayout

Output

`docs/diagrams/{feature}/erd-{slug}.drawio`

References

  • @_templates/erd.drawio
  • @.claude/rules/drawio-conventions.md
  • Advanced: skill `/diagram` + `scripts/sqlerd.py`
Read more
@khaitrang1995
Ships withagentic-awesome-kits

Reusable AI Skill Kits for coding agents (Claude Code and any other subagent/slash-command-compatible tool).

Stars on GitHub

Momentum

stars in total
10
Star history of KhaiTrang1995/agentic-awesome-kits on GitHub, a chart by star-history.com

Other skills on agentic-awesome-kits.

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills11d309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc13d293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react2d252k
@facebook@facebookInstall Skill

Questions about erd.

Which coding agents can use erd?
erd installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.