--- title: "Mermaid diagram author: review, role & definition · Undominated.ai" canonical: https://undominated.ai/agents/wshobson-mermaid-expert/ description: "A diagram-authoring profile that asks for readable Mermaid source and a rendered check." --- # Mermaid diagram author: review, role & definition · Undominated.ai > A diagram-authoring profile that asks for readable Mermaid source and a rendered check. [← Explore all agents](/agents/) DOCUMENTATION / Seth Hobson # Mermaid diagram author A diagram-authoring profile that asks for readable Mermaid source and a rendered check. [Use this definition ↓](#setup)[Original source ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md) SOURCE REVIEW Reviewed 2026-10-14 Evidence 3 linked sources Publisher Seth Hobson Licence [MIT ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/LICENSE) Revision 46891e7e60da [Read what was—and wasn’t—checked ↓](#review) “Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures. Masters syntax for all diagram types and styling. Use PROACTIVELY for visual documentation, system diagrams, or process flows.” [Seth Hobson · upstream description ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md) Our analysis follows below. 01 / THE REASONING ## Why this made the selection. - It chooses the diagram type from the data and explicitly asks for a rendering test before delivery. - Basic and styled variants are required, with comments for complex syntax and accessibility considerations. ### A good fit for - Supply the process, entities or message sequence and the intended reader. - Receive basic and styled diagram variants with rendering and export guidance. ### Weigh up before choosing - No renderer is bundled; a model can emit invalid syntax, and a requested preview is not evidence that rendering happened. - Unchanged definition, licence and attribution are downloadable; the download does not install the host or the external toolchain. 02 / THE REVIEW RECORD ## What we actually inspected. Source review has boundaries. A clear record is more useful than a “safe” badge. ### Material inspected - plugins/documentation-generation/agents/mermaid-expert.md (pinned complete source retained) - LICENSE - Repository README and current official host configuration documentation ### Our findings - It chooses the diagram type from the data and explicitly asks for a rendering test before delivery. - Basic and styled variants are required, with comments for complex syntax and accessibility considerations. ### Not established by this review - Source review only: no agent was installed or invoked. Task correctness, effective host restrictions and integration behaviour were not tested. The review applies to the material and revision named here. A newer upstream release can change its behavior. 03 / PUT IT TO WORK ## Use the role in your project. [Upstream setup instructions ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md) - Read the pinned source and its licence, then configure an explicitly bounded host context. - Load the Markdown in a bounded host and provide a compatible Mermaid renderer for actual preview checks. - Supply the process, entities or message sequence and the intended reader. ### Before you start - A documented process or architecture - Mermaid renderer when validating output ### Compatibility Claude Code ### Implementation Markdown ### Host-mediated agent profile - No tools allowlist is declared. Claude Code inherits tools from the parent when tools is omitted; restrict file, shell and network access in the host. ### Cost model The definition has the stated open-source licence. Model/host usage and any connected service or execution environment can incur separate costs. THE COMPLETE REVIEWED DEFINITION ## Read it before you reuse it. Original source bytes, with attribution. Review the host-specific setup notes above. Copy definition ↗ [Download definition + licence ↗](/resources/agents/wshobson-mermaid-expert/bundle.zip)[Raw Markdown ↗](/resources/agents/wshobson-mermaid-expert/definition.md) --- name: mermaid-expert description: Create Mermaid diagrams for flowcharts, sequences, ERDs, and architectures. Masters syntax for all diagram types and styling. Use PROACTIVELY for visual documentation, system diagrams, or process flows. model: haiku --- You are a Mermaid diagram expert specializing in clear, professional visualizations. ## Focus Areas - Flowcharts and decision trees - Sequence diagrams for APIs/interactions - Entity Relationship Diagrams (ERD) - State diagrams and user journeys - Gantt charts for project timelines - Architecture and network diagrams ## Diagram Types Expertise ``` graph (flowchart), sequenceDiagram, classDiagram, stateDiagram-v2, erDiagram, gantt, pie, gitGraph, journey, quadrantChart, timeline ``` ## Approach 1. Choose the right diagram type for the data 2. Keep diagrams readable - avoid overcrowding 3. Use consistent styling and colors 4. Add meaningful labels and descriptions 5. Test rendering before delivery ## Output - Complete Mermaid diagram code - Rendering instructions/preview - Alternative diagram options - Styling customizations - Accessibility considerations - Export recommendations Always provide both basic and styled versions. Include comments explaining complex syntax. The download contains mermaid-expert.md . Keep its filename when placing it in the agent directory described above. By **Seth Hobson**. [Exact upstream source ↗](https://raw.githubusercontent.com/wshobson/agents/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md) · [Licence](/resources/agents/wshobson-mermaid-expert/LICENSE.txt) · [Attribution](/resources/agents/wshobson-mermaid-expert/ATTRIBUTION.txt) SHA-256 13efaddbe882b125326855ebc616a6896723ec3d7f988f90132da99ce29fcea0 Read the applicable licence MIT License Copyright (c) 2024 Seth Hobson Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 04 / FOLLOW THE EVIDENCE ## The source trail. Our notes are separate from the original resource. Check upstream before adopting a new version. - [Pinned upstream agent definition ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md) Checked 2026-10-14 https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md Supports: Workflow, inputs, outputs and stated boundaries - [Applicable licence ↗](https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/LICENSE) Checked 2026-10-14 https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/LICENSE Supports: Redistribution and attribution - [Host configuration and tool inheritance ↗](https://code.claude.com/docs/en/sub-agents.md) Checked 2026-10-14 https://code.claude.com/docs/en/sub-agents.md Supports: Host loading and effective permission boundaries KEEP COMPARING ## Other approaches to consider. Related by category or shared topics. These are alternatives to inspect, not a measured quality order. [### Wiki writer ↗ Microsoft deep-wiki agent that writes VitePress markdown with dark-mode Mermaid diagrams and a citation for each claim, and that refuses to write before the git remote is resolved.](/agents/microsoft-wiki-writer/)[### API Documenter ↗ Builds API documentation as a contract-first artefact — OpenAPI 3.1 specifications, SDK generation and developer portals — with documentation-driven testing that validates examples and responses against the schema.](/agents/wshobson-api-documenter/)[### Comment Analyzer ↗ Checks comments and docstrings against implementation behavior, then separates factual errors, worthwhile improvements and obsolete explanations.](/agents/anthropic-comment-analyzer/) [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/) ## Continue your investigation - [Find reusable instructions](/skills/) - [Inspect connections](/mcp-servers/) - [Build a toolkit](/tools/) - [Choose the model](/compare/)