DOCUMENTATION / Seth Hobson
Mermaid diagram author
A diagram-authoring profile that asks for readable Mermaid source and a rendered check.
“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.”
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.
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.
- 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
THE COMPLETE REVIEWED DEFINITION
Read it before you reuse it.
Original source bytes, with attribution.
Review the host-specific setup notes above.
---
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 ↗ · Licence · Attribution
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.
https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/plugins/documentation-generation/agents/mermaid-expert.md
Supports: Workflow, inputs, outputs and stated boundaries
- Applicable licence ↗Checked
https://github.com/wshobson/agents/blob/46891e7e60da0e52baf1050b7b6391b64e84c6d9/LICENSE
Supports: Redistribution and attribution
https://code.claude.com/docs/en/sub-agents.md
Supports: Host loading and effective permission boundaries