How do I install the Terminal Diagrams skill?

Run npx skillmds@latest add roacherm/terminal-diagrams in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Terminal Diagrams safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Terminal Diagrams?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Terminal Diagrams free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Terminal Diagrams?

roacherm (@roacherm) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Terminal Diagrams by roacherm — Agent Skill

Name: Terminal Diagrams
Author: roacherm

Terminal Diagrams

在终端里给用户看图：流程图、架构图、时序图、状态图、类图、ER 图。用户读的是终端，Mermaid 代码块显示不出来，所以任何要画图、画流程、画调用关系、画数据流、'show me'、'画个图'、'流程是什么'、diagram / flowchart / sequence / architecture 的场合都先加载本 skill，用 mmd2txt 把 Mermaid 渲染成框线字符图再贴出来。

roacherm Updated Sep 17, 2026

File contents

terminal-diagrams

用户在终端里读回复，```mermaid 代码块对他只是一堆源码。mmd2txt（https://github.com/RoacherM/mmd2txt，内置 lovely-mermaid 渲染引擎，就是 pi / Grok Build 终端里画图的那套算法）把 Mermaid 源码变成框线字符图。它是 PATH 上的一个命令，不在本 skill 里；没有就先装：npm install -g github:RoacherM/mmd2txt（Node ≥ 20）。

固定规则

回复里永远不出现 mermaid 代码块。图先渲染，贴 text 块。
先把 Mermaid 写到临时目录的 .mmd 文件，再渲染；不要把源码塞进命令行参数：

mmd2txt flow.mmd                 # 退出码 0 直接贴；2 = 超过 100 列，拆成两张或缩短标签；1 = 图种不支持，改画文本树
mmd2txt --md reply.md            # 整篇 Markdown 里的 mermaid 块就地换成文本图
mmd2txt --ansi flow.mmd          # 给用户在 shell 里看的带色版本

支持 flowchart/graph、sequenceDiagram、stateDiagram、classDiagram、erDiagram、pie、mindmap、timeline、gitGraph。甘特图等不支持，用文本树或表格代替。
超宽时工具会自动试另一个方向（LR ↔ TD），仍超宽才报 2。一张图超过 100 列就拆：主路径一张、循环/异常一张。
标签用短语，不写整句；中文标签占两列，更要短。
布局引擎偶尔会让一条线从无关的框上穿过，贴图时用一句话说明这条线的实际去向。
文本树、伪代码、目录树本来就是文本，不经过本工具。

兜底

scripts/mmd-guard.js 是 Claude Code / Codex 的 Stop hook：回复结束时若仍含 mermaid 块，就渲染好交回 agent 重发。看到它的提示照做即可，不要争辩。

安装到本机（一次）

npm install -g github:RoacherM/mmd2txt        # 命令本体
node <本 skill 目录>/scripts/setup.js        # 检查 mmd2txt 在 PATH 上，注册两个 agent 的 Stop hook，打印要加进 CLAUDE.md / AGENTS.md 的规则行
node <本 skill 目录>/scripts/setup.js --remove

---name: terminal-diagramsdescription: 在终端里给用户看图：流程图、架构图、时序图、状态图、类图、ER 图。用户读的是终端，Mermaid 代码块显示不出来，所以任何要画图、画流程、画调用关系、画数据流、'show me'、'画个图'、'流程是什么'、diagram / flowchart / sequence / architecture 的场合都先加载本 skill，用 mmd2txt 把 Mermaid 渲染成框线字符图再贴出来。---# terminal-diagrams用户在终端里读回复，```mermaid 代码块对他只是一堆源码。`mmd2txt`（https://github.com/RoacherM/mmd2txt，内置 lovely-mermaid 渲染引擎，就是 pi / Grok Build 终端里画图的那套算法）把 Mermaid 源码变成框线字符图。它是 PATH 上的一个命令，不在本 skill 里；没有就先装：`npm install -g github:RoacherM/mmd2txt`（Node ≥ 20）。## 固定规则- 回复里**永远不出现** ```mermaid 代码块。图先渲染，贴 ```text 块。- 先把 Mermaid 写到临时目录的 `.mmd` 文件，再渲染；不要把源码塞进命令行参数：```bashmmd2txt flow.mmd # 退出码 0 直接贴；2 = 超过 100 列，拆成两张或缩短标签；1 = 图种不支持，改画文本树mmd2txt --md reply.md # 整篇 Markdown 里的 mermaid 块就地换成文本图mmd2txt --ansi flow.mmd # 给用户在 shell 里看的带色版本```- 支持 flowchart/graph、sequenceDiagram、stateDiagram、classDiagram、erDiagram、pie、mindmap、timeline、gitGraph。甘特图等不支持，用文本树或表格代替。- 超宽时工具会自动试另一个方向（LR ↔ TD），仍超宽才报 2。一张图超过 100 列就拆：主路径一张、循环/异常一张。- 标签用短语，不写整句；中文标签占两列，更要短。- 布局引擎偶尔会让一条线从无关的框上穿过，贴图时用一句话说明这条线的实际去向。- 文本树、伪代码、目录树本来就是文本，不经过本工具。## 兜底`scripts/mmd-guard.js` 是 Claude Code / Codex 的 Stop hook：回复结束时若仍含 mermaid 块，就渲染好交回 agent 重发。看到它的提示照做即可，不要争辩。## 安装到本机（一次）```bashnpm install -g github:RoacherM/mmd2txt # 命令本体node <本 skill 目录>/scripts/setup.js # 检查 mmd2txt 在 PATH 上，注册两个 agent 的 Stop hook，打印要加进 CLAUDE.md / AGENTS.md 的规则行node <本 skill 目录>/scripts/setup.js --remove```

Frequently asked questions