mermaid

Create diagrams and visualizations using Mermaid.js v11 syntax. Use when generating flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, user journeys, timelines, or any of 24+ diagram types. Supports CLI rendering to SVG/PNG/PDF, theming, and configuration.

Quality

86%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Failed to scan

The risk profile of this skill

Quality

Content

72%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body is a well-structured, lean overview that points cleanly to one-level-deep reference files (all verified present) and provides mostly executable examples. Its main gap is the absence of explicit validation/verification checkpoints on the CLI rendering path.

Suggestions

Add an explicit verification step to the CLI workflow, e.g. after running mmdc, open/preview the output and re-run if rendering fails, to introduce a validate-then-proceed feedback loop.

Replace the placeholder '{diagram-type} {diagram-content}' block with a second concrete, copy-paste-ready example so all shown structures are executable.

Trim the 'Common Diagram Types' list or fold it into a pointer to references/diagram-types.md to reduce redundancy with the reference file.

Dimension	Reasoning	Score
Conciseness	The body is efficient and assumes Claude's competence — no padding about what Mermaid or a flowchart is — but the 'Common Diagram Types' list and a few framing lines ('Follow these to avoid parse errors') could be trimmed slightly, so it sits just below the lean score-5 anchor.	4 / 5
Actionability	Provides copy-paste-ready concrete examples (a real flowchart, frontmatter config, and CLI commands with flags), but the opening '{diagram-type} {diagram-content}' placeholder structure is illustrative rather than executable, leaving a minor gap versus the fully-executable score-5 anchor.	4 / 5
Workflow Clarity	Sections form a loose sequence (Quick Start → Creating → Syntax Rules → CLI → Config) with syntax rules as preventive guidance, but there is no explicit render-and-verify checkpoint or feedback loop on the CLI/batch path, fitting the score-3 anchor of sequence present but checkpoints missing.	3 / 5
Progressive Disclosure	The body is a concise overview with well-signaled one-level-deep references — 'references/diagram-types.md... Load only when you need', 'See references/cli-usage.md', etc. — and all five referenced files exist, matching the score-5 anchor.	5 / 5
	Total	16 / 20 Passed

Description

100%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description is third-person, concise, and explicitly covers both what the skill does and when to use it with concrete diagram-type triggers and supported output formats. It is comprehensive without padding and clearly distinguishable from neighboring skills.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — 'Create diagrams and visualizations', a named set of diagram types (flowcharts, sequence diagrams, class diagrams, state diagrams, ER diagrams, Gantt charts, user journeys, timelines), plus 'CLI rendering to SVG/PNG/PDF, theming, and configuration' — comprehensive coverage matching the score-5 anchor.	5 / 5
Completeness	Explicitly answers both what ('Create diagrams and visualizations using Mermaid.js v11 syntax... Supports CLI rendering to SVG/PNG/PDF, theming, and configuration') and when ('Use when generating flowcharts, sequence diagrams...') with concrete trigger phrases, matching the score-5 anchor.	5 / 5
Trigger Term Quality	Natural terms a user would actually say ('flowcharts', 'sequence diagrams', 'Gantt charts', 'user journeys', 'timelines', 'diagrams') are comprehensively covered with synonyms, matching the score-5 anchor.	5 / 5
Distinctiveness Conflict Risk	Clear niche (Mermaid.js, native GitHub markdown rendering) with distinct diagram-type triggers and minimal overlap risk; the 'See Also' section even disambiguates from excalidraw, matching the score-5 anchor.	5 / 5
	Total	20 / 20 Passed

Validation

100%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: tslateman/duet
Path: skills/mermaid/SKILL.md
Commit: 5647baf

Reviewed: 3 days ago

Table of Contents

Discovery Implementation Validation

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.