📝 Mermaid
Generate Mermaid diagrams (.mmd, .mermaid files, or markdown code blocks) for flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, Gantt charts, pie charts, mindmaps, timelines, and git graphs. Use when user requests diagrams for documentation, markdown files, README visualiza
npx playbooks add skill johnlarkin1/claude-code-extensions --skill mermaid
About Mermaid
Built for documentation workflows, Mermaid helps AI coding agents generate mermaid diagrams (.mmd, .mermaid files, or markdown code blocks) for flowcharts, sequence diagrams, class diagrams, er diagrams, state diagrams, gantt charts, pie charts, mindmaps, timelines, and git graphs. use when user requests diagrams for documentation, markdown files, readme visualiza.
The 40-word prompt provides structured documentation guidance — covering detailed methodology and consistent output formats. Install it in one command.
Use Cases
- Writing API references and README files
- Generating inline code comments and docstrings
- Creating architecture decision records (ADRs)
- Keeping docs in sync with code changes
Example Prompts
System Prompt (40 words)
Generate Mermaid diagrams (.mmd, .mermaid files, or markdown code blocks) for flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, Gantt charts, pie charts, mindmaps, timelines, and git graphs. Use when user requests diagrams for documentation, markdown files, README visualiza
Frequently Asked Questions
What is Mermaid?
Mermaid is a free documentation skill for AI coding agents. Generate Mermaid diagrams (.mmd, .mermaid files, or markdown code blocks) for flowcharts, sequence diagrams, class diagrams, ER diagrams, state diagrams, Gantt charts, pie charts, mindmaps, timelines, and git graphs. Use when user requests diagrams for documentation, markdown files, README visualiza. It provides a specialized system prompt that configures your agent with documentation expertise.
How do I use Mermaid with Claude Code?
Run npx playbooks add skill johnlarkin1/claude-code-extensions --skill mermaid in your terminal to install Mermaid into your Claude Code session. It works immediately after installation.
Which AI coding agents work with Mermaid?
Mermaid is compatible with Claude Code, Cursor, GitHub Copilot, Windsurf, OpenClaw, Cline, and any AI agent that supports custom system prompts or .cursorrules files.
Is Mermaid free to use?
Yes, Mermaid is completely free and open source. The full source is available on GitHub at https://github.com/johnlarkin1/claude-code-extensions/tree/main/plugins/diagram-code/skills/mermaid. You only need a subscription to the AI agent you use it with.
