跳到主要内容

Markdown Mermaid写作 技能

使用符合版本的Mermaid结构图编写Markdown。

社区 · Clayton Young / K-Dense
作者Clayton Young / K-Dense
许可证Apache-2.0 (included skill content)
来源K-Dense-AI/scientific-agent-skills · GitHub 上的 SKILL.md
适用于Claude Code · Codex、Gemini CLI、Cursor、Copilot
读取源文件日期

markdown-mermaid-writing: 使用符合版本的Mermaid结构图编写Markdown。

用户格式和仓库惯例优先于可选内部风格。

摘自该技能的 SKILL.md: # Markdown and Mermaid Writing

这是 Clayton Young / K-Dense 发布的社区技能,未经我们或 Anthropic 审核。技能可以让智能体运行代码、读取文件或访问网络。安装前请阅读它的 SKILL.md 和文件夹中的每个脚本,留意任何与其声称用途不符的内容。

功能

  1. 描述结构、写语法并检查渲染。

产出内容

  • Markdown、Mermaid源码及可选导出。

适用场景

  • 记录过程或关系。

不适用的场景

  • 用结构图替代定量科学图。

所需条件

  • 写作无需运行时;本地渲染目标为Mermaid CLI12、Node.js22.13+和Chromium。

技能包含的文件

文件或文件夹用途
SKILL.md入口指令及配套工作流程。

2026-11-16 在仓库中查到的许可证:Apache-2.0 (included skill content)。

示例提示词

安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。

  • 用Mermaid画工作流。
  • 记录系统关系。
  • 按渲染器检查图表。

如何安装 markdown-mermaid-writing

准备工作流程

保留模板与署名;MIT仓库中的此技能内容为Apache-2.0,导出前匹配渲染目标。

技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:

Claude Code:把文件夹复制到技能文件夹

把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。

git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git
mkdir -p ~/.claude/skills
cp -R scientific-agent-skills/skills/markdown-mermaid-writing ~/.claude/skills/

Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /markdown-mermaid-writing,或直接描述任务。

在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。

Codex、Gemini CLI、Cursor 和 GitHub Copilot

这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:

git clone --depth 1 https://github.com/K-Dense-AI/scientific-agent-skills.git
mkdir -p .agents/skills
cp -R scientific-agent-skills/skills/markdown-mermaid-writing .agents/skills/
智能体项目文件夹用户文件夹说明
OpenAI Codex
.agents/skills/
~/.agents/skills/
输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。
Gemini CLI
.agents/skills/
.gemini/skills/
~/.agents/skills/
~/.gemini/skills/
也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。
Cursor
.agents/skills/
.cursor/skills/
~/.agents/skills/
~/.cursor/skills/
在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。
GitHub Copilot
.github/skills/
.agents/skills/
.claude/skills/
~/.copilot/skills/
~/.agents/skills/
适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。
只安装你信任的技能. Anthropic 的建议是只使用可信来源的技能,其他技能在使用前要读完每个文件:技能可能以其描述中未提及的方式,指示智能体运行命令、读取文件或发送数据。

这些步骤的来源

已于 2026-11-14 对照各厂商的文档核实:

结构保留在文本

可编辑源码让流程关系易审查,并遵循周围文档的惯例。

交付前渲染

版本语法、无障碍标签和实际输出检查,比未测试代码块更重要。

关于 markdown-mermaid-writing 的常见问题

复制技能会安装它的工具吗?

不会,外部需求需单独安装和配置。

本站验证了完整云端执行吗?

没有,本页提供基于源码的本地代理指导,不代表测试过云端运行。

写Markdown依赖运行时吗?

不依赖,渲染另有依赖。

能替代科学绘图吗?

不能,定量图应使用合适绘图库。

更多 AI 技能

相关技能

技能分类