Stats
Actions
Available In
Tags
Plugin
diagram-expert
Generate and insert Mermaid diagrams into READMEs by analyzing your project's codebase, dependencies, and flows — covering architecture, data models, and sequences.
What's Inside
Slash Commands2
Agents2
codebase-analyzer
/codebase-analyzer
Analyses project structure, dependencies, and flows to suggest appropriate diagrams. Use when needing to understand a codebase before generating diagrams.
readme-improver
/readme-improver
Reviews project READMEs and improves them with Mermaid diagrams and visual documentation. Use when the user wants to enhance existing README files.
README
diagram-expert
A Claude Code plugin that generates detailed, accurate Mermaid diagrams from your codebase and improves READMEs with visual documentation.
What it does
- Analyses your project structure, database models, API flows, and deployment config
- Generates Mermaid diagrams that render natively on GitHub, GitLab, and Azure DevOps
- Identifies where your README could benefit from diagrams and proposes improvements
- Always asks before making changes
Installation
claude plugin marketplace add wrxck/claude-plugins
claude plugin install diagram-expert@wrxck-claude-plugins
Commands
/diagram <description>
Generate a Mermaid diagram from a description or by analysing your codebase.
/diagram architecture
/diagram sequence for the auth flow
/diagram erd
/diagram deployment
/diagram:readme [path]
Analyse a project and suggest README improvements with diagrams.
/diagram:readme
/diagram:readme ./packages/api
Supported diagram types
| Type | Mermaid keyword | Best for |
|---|---|---|
| Flowchart | graph TD/LR | Architecture, deployment, data pipelines |
| Sequence | sequenceDiagram | API flows, auth chains, multi-service interactions |
| ERD | erDiagram | Database schemas, data models |
| State | stateDiagram-v2 | Order flows, document lifecycles |
| Class | classDiagram | Service interfaces, component APIs |
| Gantt | gantt | Project timelines |
| Gitgraph | gitgraph | Branching strategies |
| Pie | pie | Proportional breakdowns |
Git provider support
| Provider | Mermaid support |
|---|---|
| GitHub | Native rendering |
| GitLab | Native rendering |
| Azure DevOps | Native rendering |
| Bitbucket | No native support (plugin offers alternatives) |
Agents
The plugin includes two specialised agents:
- codebase-analyzer -- Read-only agent that analyses project structure, dependencies, and flows
- readme-improver -- Reviews READMEs and proposes diagram improvements (always asks first)
Licence
MIT
Stats
Version1.0.0
Stars6
MaintenanceFair
LicenseMIT
Last Commit
Added
Available In
Safety Signals
Caution
Uses power tools
Uses Bash, Write, or Edit tools
Tags
Categories
'%20stop-opacity%3D'0.16'%2F%3E%3Cstop%20offset%3D'1'%20stop-color%3D'rgb(200%2C90%2C60)'%20stop-opacity%3D'0.03'%2F%3E%3C%2FlinearGradient%3E%3C%2Fdefs%3E%3Crect%20width%3D'320'%20height%3D'200'%20fill%3D'url(%23g)'%2F%3E%3Ccircle%20cx%3D'250'%20cy%3D'56'%20r%3D'92'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.06'%2F%3E%3Ccircle%20cx%3D'64'%20cy%3D'172'%20r%3D'58'%20fill%3D'rgb(200%2C90%2C60)'%20fill-opacity%3D'0.05'%2F%3E%3C%2Fsvg%3E)
