用途：当用户要求 Mermaid 图表、流程图、时序图、架构图、图表重构或可读性修复时使用。目标是产出读者一次就能正确理解、且在目标宿主上确实能渲染的图表；可读性优先于完整性。
主要能力：按读者任务选类型（流程→flowchart，调用顺序→sequenceDiagram，边界→subgraph 或 architecture-beta，生命周期→stateDiagram-v2，数据模型→erDiagram）；按阅读路径选方向；提供紧凑与详细两种细节层级；按需配色与无障碍元数据；内置语法陷阱、图表目录、配色样式、渲染兼容四份参考文件。
必要用法：基线为 Mermaid v11.16 语法，目标宿主较旧或未知时退到版本安全子集。硬性语法规则：换行用 <br/> 而非 \n；含标点的标签要加引号，如 A["validate (strict)"]；流程图与时序图不要用小写 end 作节点或标签词；流程图箭头用 --> 而非 ->；每个块要配平（subgraph/end、alt/end、activate +/-）。仓库 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>" 渲染失败需修复重跑；密度警告触发人工查看而非自动删除。
适用场景：文档与设计说明中的图表编写、图表重构、可读性修复、跨宿主渲染兼容检查。
限制：只返回被请求的产物（代码块或文件编辑），不重构周边文档、不重设既有图表主题、不擅自转换图表类型；宿主版本属于正确性的一部分，未知宿主用版本安全子集；linkStyle 索引在增删边后会偏移需复查；边标签需单独设置对比度；密度阈值只是启发式。若无法渲染，应把语法审查与视觉验证作为两项独立、诚实的结论报告。