Archify Diagrams
tt-a1i/archify
Creates interactive architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone HTML with inline SVG, themes and image or video export.
Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图，或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图，并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型，再生成可渲染、结构清晰的 Mermaid 代码，并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。
Install Mermaid
$ npx skills add chujianyun/skills --skill mermaid -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install chujianyun/skills mermaid --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/mermaid .claude/skills/mermaid && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .claude/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/chujianyun/skills/tree/main/skills/mermaidType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add chujianyun/skills --skill mermaid -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install chujianyun/skills mermaid --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/mermaid .agents/skills/mermaid && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .agents/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add chujianyun/skills --skill mermaid -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install chujianyun/skills mermaid --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/mermaid .cursor/skills/mermaid && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .cursor/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/chujianyun/skills.git --path skills/mermaid--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add chujianyun/skills --skill mermaid -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install chujianyun/skills mermaid --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/mermaid .gemini/skills/mermaid && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .gemini/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install chujianyun/skills mermaidInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add chujianyun/skills --skill mermaid -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/mermaid .github/skills/mermaid && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .github/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add chujianyun/skills --skill mermaid -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install chujianyun/skills mermaid --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/chujianyun/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/mermaid .opencode/skills/mermaid && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "mermaid" agent skill from https://github.com/chujianyun/skills/tree/main/skills/mermaid into .opencode/skills/mermaid/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "mermaid", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
mermaid- GitHub stars
- 742
- Token cost
- ~653 tokens
- SKILL.md length
- 153 words
- Files
- 2 (incl. references)
- Skills in repo
- 35
- Repo updated
- First seen
- Licence
- Custom licence
At a glance
Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图，或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图，并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型，再生成可渲染、结构清晰的 Mermaid 代码，并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。
- Works in 6 steps: 理解目标 → 选择图类型 → 抽取关键节点与关系 → …
- Tasks that involve Diagrams
- SKILL.md covers 设计模式, Gotchas, 工作流 and 输出要求, plus 1 more section
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Mermaid is an agent skill from chujianyun/skills. Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图，或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图，并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型，再生成可渲染、结构清晰的 Mermaid 代码，并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。
Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/diagram-selection.md`).
It sits in Development, covering Diagrams. It works with Mermaid. The repository describes itself as: WuMing's Claude Skills.
When your agent uses it
- Tasks that involve Diagrams
Example prompts
- “/mermaid”
Workflow steps
6 steps, taken from the step headings in SKILL.md.
- 理解目标
- 选择图类型
- 抽取关键节点与关系
- 生成 Mermaid 代码
- 自查可读性与语法
- 交付并说明
What it can do on your machine
Read from SKILL.md and the folder at commit 13b27aa. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are mermaid).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Mermaid loads about 653 tokens when it runs, and up to ~1.6k if it reads all its reference files. Until then it costs about 44 tokens; SKILL.md has 153 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
Its licence (Custom licence) doesn't allow us to republish the file, so here is its outline and opening line. It has 153 words (~653 tokens).
- name
- mermaid
Files
SKILL.md and 1 other file (references) in skills/mermaid of chujianyun/skills.
- SKILL.md
- references/diagram-selection.md
Open the folder on GitHubat commit 13b27aa
Compare with similar skills
Mermaid next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Mermaid this skillchujianyun/skills | 742 | — | ~653 | Automated safety check: Pass | Custom licence | |
| Archify Diagramstt-a1i/archify | 82k | — | ~2.9k | Automated safety check: Pass | MIT | |
| Diagram Designcathrynlavery/diagram-design | 49k | 1 repos | ~7.6k | Automated safety check: Pass | MIT | |
| Draw.io Diagram StudioAgents365-ai/drawio-skill | 10k | — | ~2.4k | Automated safety check: Notes | MIT | |
| Pretty Mermaid Rendererimxv/Pretty-mermaid-skills | 1.5k | — | ~2k | Automated safety check: Pass | MIT | |
| Archify Diagram BuilderUnclecheng-li/AI_Animation | 1.5k | 2 repos | ~4.1k | Automated safety check: Pass | MIT |
Similar skills
Diagram Design
cathrynlavery/diagram-design
Creates branded diagrams, from architecture, flowchart and sequence to charts and maps, as self-contained HTML with inline SVG, with import from draw.io, Mermaid and Excalidraw.
Draw.io Diagram Studio
Agents365-ai/drawio-skill
Creates and edits editable draw.io diagrams from descriptions, code, infrastructure files, SQL and API schemas, with sync, review, test and export tools.
Pretty Mermaid Renderer
imxv/Pretty-mermaid-skills
Writes and renders Mermaid diagrams as themed SVG, PNG or terminal ASCII and Unicode art with a bundled Node.js CLI that needs no browser.
Archify Diagram Builder
Unclecheng-li/AI_Animation
Builds validated architecture, workflow, sequence, data-flow and lifecycle diagrams as standalone interactive HTML from a small JSON spec, with optional motion and image export.
Mermaid
WH-2099/mermaid-skill
Generate Mermaid diagrams from user requirements. An agent skill from WH-2099/mermaid-skill.
More from chujianyun/skills
All 35 skills in this repoBaize
chujianyun/skills
将公开或用户有权访问的 Wiki 完整转换为面向 Agent 的离线知识 Skill，并按原 Wiki 层级保存 Markdown、生成检索索引和逐文档哈希清单，支持无变化不落盘的手动或自动增量更新。当用户要求把 Wiki、文档站或帮助中心做成 Skill、同步已有 Wiki Skill、保持文档目录树或设置 Wiki Skill 自动更新时使用；不用于只摘要单篇网页或绕过登录、付费墙和访问控制。
Add Photo Certificate Watermarks
chujianyun/skills
为照片、身份证、护照、学位证、毕业证、资格证、营业执照等证件或证书扫描件及 PDF 添加本地文字水印。用户提出照片加版权水印、身份证或学历证件添加“仅限某用途”水印、资质文件批量加水印、生成水印预览，或需要保持头像、二维码、印章等区域可辨认时使用。支持 JPEG、PNG、WebP 和 PDF，默认先预览、保留原件并清除图片元数据。不用于去除水印、伪造或篡改证件内容，也不用于仅设计 Logo…
GitHub Code Interpreter
chujianyun/skills
GitHub 源码解读助手。适用于用户提供 GitHub 仓库链接，并希望解读源码、理解原理、分析架构、生成学习报告或快速上手文档时使用。会在 working 目录下生成源码解读和快速上手两份文档。默认先交付初稿，不自动复查；如果用户明确同意，再安排后续复查。不适用于仅克隆仓库或只要一句简介的场景。
Llama Index Wiki
chujianyun/skills
LlamaIndex 官方用户文档离线知识库，用于检索并回答 LlamaIndex Python 框架的安装、RAG、数据加载、索引、检索与查询、Agent、Workflow、模型、Embedding、向量库、评估、可观测性、部署、LlamaCloud 和 LlamaParse 等问题，也可生成有文档依据的示例代码与排障建议。当用户提到…
Paper Interpreter
chujianyun/skills
论文解读助手。适用于用户发送 arXiv 论文链接，并希望下载论文、解读论文、生成读书笔记、做论文拆解或输出详细报告时使用。会在工作目录创建论文文件夹、下载 PDF 与 TeX Source（如有）、生成中文 Markdown 报告。默认先交付初稿，不自动复查；如果用户明确同意，再安排后续复查。不适用于只要简短推荐语的情况。
Qianwenai Wiki
chujianyun/skills
千问AI平台（Qianwen AI Platform / DashScope）官方文档离线知识库，用于检索并回答模型选择、API Key、OpenAI 兼容接口、DashScope SDK、文本与多模态生成、图像/视频/语音、Realtime API、Embedding、Reranking、Function Calling、MCP、批量调用、计费、Token Plan、API/SDK/CLI…
Related
Works with
Categories
Questions about Mermaid
What does Mermaid do?
Mermaid 图绘制助手。适用于用户明确要求绘制 Mermaid 图，或提到流程图、架构图、时序图、状态图、甘特图、ER 图、用户旅程图、类图，并希望直接输出 Mermaid 代码块时使用。会先判断最合适的图类型，再生成可渲染、结构清晰的 Mermaid 代码，并在必要时附上简短说明或迭代建议。不适用于追求高保真视觉设计稿的场景。. Mermaid is an agent skill from chujianyun/skills.
When should I use Mermaid?
Mermaid fits situations like: tasks that involve Diagrams.
How do I install Mermaid in Claude Code?
Run `npx skills add chujianyun/skills --skill mermaid -a claude-code`. Or copy the skill folder (skills/mermaid in chujianyun/skills) into .claude/skills/mermaid in your project. Claude Code loads it when a task matches its description.
How do I install Mermaid in Codex?
Run `npx skills add chujianyun/skills --skill mermaid -a codex`. Or copy the skill folder (skills/mermaid in chujianyun/skills) into .agents/skills/mermaid in your project. Codex loads it when a task matches its description.
Can I use Mermaid in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add chujianyun/skills --skill mermaid -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/mermaid, .gemini/skills/mermaid, .github/skills/mermaid and .opencode/skills/mermaid in your project.
What does Mermaid need to run?
SKILL.md names no scripts, command-line tools or credentials: Mermaid is instructions for the agent only.
Does Mermaid access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Mermaid safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Mermaid use?
Mermaid has a licence file (the repository's licence) that doesn't match a standard licence. Read it on GitHub before reusing the skill.
How many tokens does Mermaid use?
About 653 tokens (SKILL.md is roughly 2.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 981 tokens, read only when the agent opens those files.
What are the alternatives to Mermaid?
Skills that share tags, products or a category with Mermaid: Archify Diagrams (tt-a1i/archify, 82k stars), Diagram Design (cathrynlavery/diagram-design, 49k stars), Draw.io Diagram Studio (Agents365-ai/drawio-skill, 10k stars) and Pretty Mermaid Renderer (imxv/Pretty-mermaid-skills, 1.5k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Mermaid?
chujianyun (a GitHub user) maintains it in chujianyun/skills, which has 742 GitHub stars. The repository holds 35 skills in this directory. The repository was last updated on October 9, 2026.
Source: chujianyun/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.