sql-to-er

Name: sql-to-er
Author: zhouyanye

Pending

SQL → classic Chen ER diagrams & Word design docs. CLI + Agent Skill. Online: yanleaf.com/tools/sql-to-er

0stars

0forks

Python

Installation

# Add to your Claude Code skills
git clone https://github.com/zhouyanye/sql-to-er

Getting Started

Guides for using ai agents skills like sql-to-er.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

SKILL.md

README.md

Frequently Asked Questions

What is sql-to-er?

sql-to-er is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by zhouyanye. SQL → classic Chen ER diagrams & Word design docs. CLI + Agent Skill. Online: yanleaf.com/tools/sql-to-er. It has 0 GitHub stars.

Is sql-to-er safe to use?

sql-to-er's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.

How do I install sql-to-er?

Clone the repository with "git clone https://github.com/zhouyanye/sql-to-er" and add it to your Claude Code skills directory (see the Installation section above). sql-to-er ships a SKILL.md manifest, so compatible agents can discover and load it automatically.

What programming language is sql-to-er written in?

sql-to-er is primarily written in Python. It is open-source under zhouyanye on GitHub, so you can review or fork the full source.

Are there alternatives to sql-to-er?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh sql-to-er against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

ECC

by affaan-m

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

256,673

sprakvask task-delegate

⚠️ Third-Party Software Notice

This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.

Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.

Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.

Read the Terms of Service

name: er-diagram description: Generate classic Chen-style ER diagrams from SQL DDL, pasted CREATE TABLE, or natural-language data model requests. Trigger on ER/ERD/entity-relationship/schema diagram/SQL转ER图, or when user asks to design tables and draw an ER diagram. Outputs only what the user asked for (Chen PNG by default; Mermaid/Word/GoJS only on request). SQL parse via yanleaf.com API with local fallback.

ER Diagram (SQL → ER)

经典 Chen 风格 ER 图 +（按需）Word 三线表 / Mermaid / GoJS。

触发条件

在以下情况使用：

用户提供 .sql / 粘贴 CREATE TABLE，并要求出图或设计文档
用户明确要求：ER 图 / ERD / SQL转ER / 数据库设计文档
用户用自然语言描述业务并要求「设计表结构并画 ER 图」（由当前模型设计 list-of-tables，不要调用 yanleaf 的 AI 接口）

不要在仅讨论 SQL 语法、改某一个字段时自动出图。

产出什么（按需，不要默认全出）

只生成用户要的东西。 未点名的格式不要跑、不要塞给用户。

用户说法	生成
画 ER 图 / 生成 ERD / 看看图	仅 PNG（`--format png`）
要 Mermaid / 要代码块图	仅 Mermaid（`--format mermaid`）
数据库设计文档 / 三线表 / Word / docx	仅 Word（`--format word`）
GoJS / 给前端用的 JSON	仅 GoJS（`--format gojs`）
全部 / 图和文档都要 / 导出全套	`--format all`

默认（只说「画个 ER 图」）：PNG only。

不要默认执行 --format all。

SQL 路径

# 只要图（最常见）
python scripts/sql_to_erd.py schema.sql --out /tmp/erd --format png

# 只要 Word
python scripts/sql_to_erd.py schema.sql --out /tmp/design --format word

# 用户明确要全套
python scripts/sql_to_erd.py schema.sql --out /tmp/erd --format all

解析：优先 https://yanleaf.com/api/tools/er-diagram/parse，失败本地 sql_parser.py。

引擎：--engine auto（有 dot 用 Graphviz，否则 matplotlib）。一般无需改。

自然语言路径

按规范设计 list-of-tables（snake_case、主键、外键 xxx_id、审计字段、3NF）。
写入 JSON 后只渲染用户要的格式，例如只要图：

python scripts/render_chen.py /tmp/tables.json /tmp/erd.png yanleaf.com

只要 Word 则用 export_word.py，不要顺手再出 PNG/Mermaid。

关系与精简

外键所在表 = N，被引用表 = 1（不要画反）
字段很多或用户说「只要关系」：保留 PK + FK + 少量关键字段（--max-attrs）
用户说重画：按新要求再生成，仍只出其需要的格式

依赖（Python 3.9+）

pip install sqlparse pyyaml python-docx pillow matplotlib graphviz

Graphviz 系统包可选；没有也能出 PNG。中文需系统字体或 assets/ 内字体。

脚本

文件	作用
`sql_to_erd.py`	SQL 入口（用 `--format` 控制产物）
`render_chen.py`	matplotlib Chen PNG
`api_client.py`	yanleaf parse API
`sql_parser.py`	本地解析回退
`generate_erd.py`	Mermaid / GoJS / Graphviz DOT
`export_word.py`	Word 三线表
`watermark.py`	Graphviz PNG 水印

在线工具：https://yanleaf.com/tools/sql-to-er

sql-to-er

SQL → 经典 Chen 风格 ER 图 & Word 三线表设计文档。

作者：zhouyanye · 在线版：https://yanleaf.com/tools/sql-to-er

功能

解析 MySQL / PostgreSQL / SQL Server / Oracle 常见 CREATE TABLE
Chen 图：经典黑白（有 Graphviz 优先用；否则 matplotlib 黑白回退，不必强装 Graphviz）
导出 Mermaid、GoJS JSON、Word 三线表
解析优先 yanleaf API，失败本地回退
可作为 Agent Skill 使用（见 SKILL.md）

环境要求

Python 3.9+（3.10 / 3.11 / 3.12 均可）
pip 国内镜像源

pip config set global.index-url https://mirrors.tuna.tsinghua.edu.cn/pypi/web/simple

pip 依赖：

pip install sqlparse pyyaml python-docx pillow matplotlib graphviz

有系统 Graphviz（dot）时 PNG 更接近官网布局；没有则自动用 matplotlib 黑白图。SVG/DOT 仍需要 Graphviz。

系统 Graphviz（可选）

系统	安装
Windows	Graphviz 安装包或 `winget install Graphviz.Graphviz`（Chocolatey 需管理员时可用安装包/便携版）
macOS	`brew install graphviz`
Ubuntu/Debian	`sudo apt install graphviz`
Fedora	`sudo dnf install graphviz`

装不上可忽略，PNG 仍可用。

中文显示

matplotlib 会按顺序尝试：assets/ 内字体 → Noto CJK → 微软雅黑 → 黑体 → 文泉驿 → PingFang。

若中文仍为方框，任选其一：

Windows：已自带微软雅黑，一般无需处理
macOS：系统 PingFang 即可
Linux：sudo apt install fonts-noto-cjk 或把 .ttf/.otf 放进 assets/

用法

# 推荐：图 + Word + Mermaid
python scripts/sql_to_erd.py your.sql --out erd --format all

# 只要 PNG
python scripts/sql_to_erd.py your.sql --format png --out erd

# 只要 Word
python scripts/sql_to_erd.py your.sql --format word --out design

# 强制本地解析、关闭水印
python scripts/sql_to_erd.py your.sql --no-api --no-watermark --format png

作为 Skill

复制本目录到 Agent skills 路径（如 .grok/skills/er-diagram/）。

用户给 SQL → 解析并出图
用户说「按某某业务画 ER 图」→ 由当前模型设计表结构再渲染（不调用 yanleaf AI 接口）

er-diagram/
├── SKILL.md
├── README.md
├── LICENSE
├── scripts/
│   ├── sql_to_erd.py
│   ├── render_chen.py      # matplotlib Chen 渲染
│   ├── api_client.py
│   ├── sql_parser.py
│   ├── generate_erd.py
│   ├── export_word.py
│   └── watermark.py
└── assets/
    ├── DejaVuSans.ttf
    └── example-model.yaml

效果示例

Chen ER

License

DejaVu 字体遵循其原许可。