用途：产出人类一次就能读懂的 Mermaid 图表源码，并确保在目标宿主上真正渲染成功。可读性优先于完整性。
主要能力：基于 Mermaid v11.17 语法，在宿主版本较旧或未知时退回到版本安全子集；Mermaid v12（GitHub 使用）保留该语法但改变默认布局、主题与外观。提供参考文件：syntax-pitfalls.md（换行陷阱、解析器破坏、转义、frontmatter 配置）、diagram-catalog.md（选类型与细节层级）、color-and-style.md（配色与主题变量、暗色模式）、renderer-compat.md（宿主矩阵、版本门槛、校验流程）。
必要语法规则：换行用 <br/> 而非 \n；含标点的标签要加引号，如 A["validate (strict)"]；流程图与序列图中不要用小写 end 作节点或标签词；流程图箭头是 --> 而非 ->；每个块要配平（subgraph/end、alt/end、activate +/-）。
使用方式：先用一句话说明读者要验证什么，按读者任务选类型（流程→flowchart，调用顺序→sequenceDiagram，边界→subgraph 或 architecture-beta，生命周期→stateDiagram-v2，数据模型→erDiagram）；方向按阅读路径选择；按概览或设计文档选择紧凑或详细形式；仅在颜色承载含义时着色，颜色不超过 4 种。校验时对仓库 Markdown 运行随附脚本： SKILL_DIR="<absolute path to this skill>" "$SKILL_DIR/scripts/assess_mermaid_density.sh" "<absolute markdown path>" "$SKILL_DIR/scripts/validate_mermaid_markdown.sh" "<absolute markdown path>" 校验器默认用 Mermaid 12（同 GitHub），v11 宿主可设 MERMAID_CLI_VERSION=11.17.0。渲染失败必须修复后重跑；密度警告只触发人工查看。
适用场景：GitHub、Linear、Obsidian 等自行渲染 Mermaid 的宿主，以及用户明确要求 Mermaid 源码的交付物。
限制：宿主版本属于正确性的一部分，旧引擎上 markdown 字符串、@{ shape: }、ELK 与 beta 图表类型会失败或降级；未知宿主应使用版本安全子集。linkStyle 索引在增删边后会偏移，需重新检查。边标签需单独设置 edgeLabelBackground 与 textColor 以保证明暗主题可读。密度阈值只是启发式，必需节点与关系应保留。只返回被要求的产物，不重构周边文档或转换图表类型。未提供的收费、价格、平台等信息暂未提供。