Mermaid Expert

This turns natural language requests into properly formatted Mermaid diagrams across the full spectrum of types: flowcharts, sequence diagrams, ERDs, state machines, Gantt charts, and more. It knows the syntax quirks for each diagram type and gives you both basic and styled versions with comments explaining the markup. Useful when you need to visualize system architecture, document API flows, or map out database schemas without looking up Mermaid docs every time. The skill pushes for readability and consistent styling, which matters when diagrams end up in production documentation. It covers the less common types too like quadrant charts and journey maps, not just the standard flowchart stuff.

skills.sh installs: 355
GitHub stars: 39.4K
last updated: Jun 3, 2026

View on GitHub

Install

$ npx -y skills add sickn33/antigravity-awesome-skills --skill mermaid-expert --agent claude-code

Installs into .claude/skills of the current project.

Files

Use this skill when

Converting verified processes, interactions, schemas or state transitions into a Mermaid diagram.
Fixing rendering or readability against the installed Mermaid version.

Do not use this skill when

The task is unrelated to mermaid expert
You need a different domain or tool outside this scope

Instructions

Clarify goals, constraints, and required inputs.
Apply relevant best practices and validate outcomes.
Provide actionable steps and verification.

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

SKILL.md on GitHub

Details

Repository: github.com/sickn33/antigravity-awesome-skills
First seen: Jun 3, 2026