用途：依据内容生成 Mermaid 图表文件，让图不只是罗列文字，而是表达关系、因果和流程。面向需要可视化工作流、架构或概念的场景。
主要能力：提供图表类型决策参考，覆盖 flowchart、sequence、mindmap、state、class、C4、timeline、er-diagram、sankey 等；附语法陷阱、主题样式、已验证示例与渲染脚本。强调同构检验（去掉文字后结构本身能否传达概念）和教育价值，建议为不同受众分别制图，节点一般不超过约20个，过大则拆分。
使用方式：默认生成 .mmd 文件；用户说 embed、add to docs、add to README 或目标为 .md 文件时，改用 ```mermaid 围栏块。渲染命令为：bash .claude/skills/mermaid-diagram-skill/references/render_mermaid.sh <path.mmd> [output.png]。首次运行会通过 npx 下载 mmdc，可能约30秒。渲染属强制验证环节：语法报错要看错误并参考语法陷阱文件修正；渲染成功后查看 PNG，检查布局，通过调整声明顺序、rankDir、子图等方式改进，反复渲染直到清晰。标签含括号、逗号、@、/、<、>、: 时应写成 ["label text"]。使用 flowchart 而非 graph；标签为 end 的节点需引用；无法按像素定位元素。文档完成后可清除临时 png 或 mmd 文件。
限制：不支持像素级精确排布；明确排除饼图、甘特图、Git Graph、XY Chart、User Journey 等类型；渲染细节与主题定制依赖技能内引用文件，具体收费、平台要求等资料暂未提供。