Mermaid

Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图,或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图,并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型,再生成可渲染、结构清晰的 Mermaid 代码,并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。

757 stars 102 forksOther Plugin marketplace

Install

Claude Code plugin
/plugin marketplace add chujianyun/skills

The repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add chujianyun/skills --skill mermaid
Manual install
git clone --depth 1 https://github.com/chujianyun/skills.git /tmp/skills
mkdir -p ~/.claude/skills
cp -r /tmp/skills/skills/mermaid ~/.claude/skills/mermaid

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Mermaid

专门用于把结构、流程、关系和时间顺序整理成 Mermaid 图。

## 设计模式

本 skill 主要采用:
- **Generator**:根据用户需求或现有文本直接生成 Mermaid 图
- **Reviewer**:先判断该用哪种图,再决定是否需要补最小必要信息

## Gotchas

- 不要一上来就默认 `flowchart`,先判断是否更适合时序图、状态图、ER 图或甘特图
- 不要把段落原文整段塞进节点,节点文字要短、可扫描
- 不要为了“信息完整”把一张图画得过满;必要时提醒用户拆成两张图
- 不要输出明显无法渲染的 Mermaid 代码;交付前自查括号、连线、缩进和子图闭合
- 在 `flowchart` 中,如果节点文本里包含 `/plan-ceo-review` 这类带斜杠的字符串,不要写成 `E1[/plan-ceo-review<br/>CEO视角审视产品]`,要写成 `E1["/plan-ceo-review"<br/>CEO视角审视产品]`,否则容易触发语法错误
- 如果用户只说“画个 Mermaid 图”但材料很少,先基于现有信息做一个合理初稿,不要过度追问
- 如果需求本质上是“做一张好看的配图”而不是 Mermaid 语法图,明确说明边界

## 工作流

复制此清单并跟踪进度:

```text
绘图进度:
- [ ] 步骤 1:理解目标
- [ ] 步骤 2:选择图类型
- [ ] 步骤 3:抽取关键节点与关系
- [ ] 步骤 4:生成 Mermaid 代码
- [ ] 步骤 5:自查可读性与语法
- [ ] 步骤 6:交付并说明
```

### Step 1: 理解目标

先判断用户要表达的核心是什么:

- **流程推进**:某件事按步骤如何发生
- **结构分层**:系统、模块、组织或页面如何组成
- **交互时序**:角色或服务之间如何来回通信
- **状态变化**:对象如何在不同状态间切换
- **数据关系**:实体与字段之间如何关联
- **项目安排**:任务、时间、依赖如何分布
- **用户体验路径**:用户在一段旅程中的动作和感受

如果用户给的是文章、方案、PRD、会议纪要或口头描述,先提炼成“节点 + 关系 + 顺序/层级”。

### Step 2: 选择图类型

优先根据表达目标选择图类型。需要时读取 [references/diagram-selection.md](references/diagram-selection.md)。

快速判断:

- 讲步骤和分支:`flowchart`
- 讲服务/角色之间的调用顺序:`sequenceDiagram`
- 讲状态切换:`stateDiagram-v2`
- 讲数据库或业务实体关系:`erDiagram`
- 讲排期、里程碑、依赖:`gantt`
- 讲用户体验过程:`journey`
- 讲对象/模块的静态关系:`classDiagram`
- 讲 git 分支关系:`gitGraph`

如果用户指定了图类型,优先尊重;仅在明显不合适时再说明替代建议。

### Step 3: 抽取关键节点与关系

生成前先做轻量结构化:

- 列出 3 到 9 个关键节点
- 明确节点之间的主关系:顺序、包含、依赖、调用、状态转移、拥有
- 保留主线,删掉次要修饰语
- 给节点命名时优先短中文或稳定英文术语

如果一张图超过 12 个核心节点,优先压缩、分组,或建议拆图。
Read the full skill on GitHub

Details

Skill name
mermaid
Path
skills/mermaid/SKILL.md
Repo updated
14 November 2026

FAQ

What does the Mermaid skill do?

Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图,或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图,并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型,再生成可渲染、结构清晰的 Mermaid 代码,并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。

How do I install the Mermaid skill?

Claude Code plugin: /plugin marketplace add chujianyun/skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Mermaid popular?

It lives in chujianyun/skills, which has 757 GitHub stars and 102 forks.

Related skills

Add Photo Certificate Watermarks

757

chujianyun/skills

为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览,或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF,默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容,也不用于仅设计 Logo 水印素材。

Images, Video & Audio102

Agent Md Advisor

757

chujianyun/skills

AGENTS.md / CLAUDE.md 最佳实践顾问。用于用户询问 agents markdown、AGENTS.md、CLAUDE.md、Claude Code memory、AI coding agent 指令文件的格式、结构、最佳实践;也用于审查、诊断、重写、优化或从零创建 AGENTS.md、CLAUDE.md、CLAUDE.local.md、.claude/rules 等 agent 指令文件。不适用于通用 README 写作,除非目标是给 AI coding agent 提供项目上下文。

AI, LLMs & Agents102

Agent Optimizer

757

chujianyun/skills

Agent 设计顾问与审查工具。基于 12-Factor AgentOps 最佳实践,用于:(1) 探讨 Agent 架构设计方案;(2) 审查现有 Agent/Skill/工作流的设计,发现问题,给出改进建议。触发词:审查我的 agent、帮我分析这个 skill、agent 设计、agent 优化、帮我 review 这个工作流、这个 agent 有什么问题、怎么设计 agent、agent 架构咨询。

AI, LLMs & Agents102

Skill Optimizer

757

chujianyun/skills

审查和优化已有 Skill。用于检查技能质量、触发边界、冗余指令或重构技能说明;不用于执行该技能的业务任务。

Other102

Five Perspective Analysis

757

chujianyun/skills

从用户、业务负责人、一线执行者、技术负责人、公司经营者五种角色视角交叉分析问题,识别各方目标、约束、风险和冲突,并综合成有优先级的判断与行动建议。适用于产品决策、技术方案、项目复盘、业务难题、职业判断,以及用户要求“换几个视角看看”“考虑得更全面”“用五种视角分析”时。不用于单纯事实查询、只需单一专业结论或必须由真实利益相关者参与的正式调研。

Other102

Wuming Ontology

757

chujianyun/skills

基于 Palantir Foundry Ontology 官方文档进行本体建模,生成 .ttl(OWL 本体)与 HTML 可视化,并检索中文离线文档。用于领域本体设计与交付,以及 Palantir 概念解释、配置和排障;不用于泛哲学本体论或其他图谱产品的配置与排障。

Other102

Browse the most popular Claude skills, all other skills, or write your own with the skills generator.