mermaid-diagrams

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts, gantt charts, or any other diagram type. Triggers include requests to "diagram", "visualize", "model", "map out", "show the flow", or when explaining system architecture, database design, code structure, or user/application flows.

1.33x

Quality

92%

Does it follow best practices?

Impact

92%

1.33x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Evaluation results

97%

24%

SaaS Subscription Platform: Database Schema Documentation

ERD diagram conventions

Criteria

Without context

With context

Uppercase entity names

100%

Singular entity names

100%

PK markers present

100%

FK markers present

100%

UK markers used

100%

Correct cardinality notation

100%

Junction table for many-to-many

75%

Timestamps included

100%

Relationship labels

100%

Comment in diagram

100%

erDiagram declaration

100%

All six entities present

100%

84%

24%

Developer Portal: OAuth 2.0 Authorization Code Flow Documentation

Sequence diagram features

Criteria

Without context

With context

actor for human user

100%

participant for system components

100%

Dotted arrows for responses

100%

autonumber present

100%

alt/else for error paths

40%

100%

opt block used

par block used

Activation markers

100%

Notes added

100%

sequenceDiagram declaration

100%

Token refresh flow

100%

No %% with curly braces

100%

96%

20%

Digital Library System: Domain Model Documentation

Class diagram conventions and theming

Criteria

Without context

With context

Visibility modifiers

100%

Inheritance relationship

100%

Realization/Interface relationship

100%

Composition vs aggregation

50%

Multiplicity on relationships

100%

Class stereotypes

100%

YAML frontmatter config

100%

base theme for custom colors

100%

Two separate diagrams

100%

Relationship labels

100%

classDiagram declaration

100%

Method syntax with return types

100%

Comments in diagrams

100%

Repository: softaworks/agent-toolkit
Commit: 3027f20

Evaluated: 30 days ago
Agent: Claude Code
Model: Claude Sonnet 4.6

Table of Contents

SaaS Subscription Platform: Database Schema Documentation Developer Portal: OAuth 2.0 Authorization Code Flow Documentation Digital Library System: Domain Model Documentation

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.