mermaid-visualizer

Transform text content into professional Mermaid diagrams for presentations and documentation. Use when users ask to visualize concepts, create flowcharts, or make diagrams from text. Supports process flows, system architectures, comparisons, mindmaps, and more with built-in syntax error prevention.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Quality

Content

77%

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

Highly actionable with concrete Mermaid examples and a clear verified workflow, but it is verbose and over-inlined: syntax rules are duplicated between the body and the reference file, and material that belongs in the reference is kept inline.

Suggestions

Move the Critical Syntax Rules detail and the full Color Scheme palette into references/syntax-rules.md, keeping only the top gotchas inline with a pointer, to remove duplication and tighten the body.

Collapse the overlapping Quick Start and Workflow sections into one sequenced procedure to cut redundancy and improve conciseness.

Trim the Diagram Types section to a compact table (type → best for → trigger) and push per-type features into the reference file.

Dimension	Reasoning	Score
Conciseness	The body is largely specialized, actionable knowledge (not generic concept padding), but it carries clear redundancy: syntax rules appear both inline and in references/syntax-rules.md, and Quick Start, Workflow, and Quality Checklist overlap on the same steps.	2 / 3
Actionability	It provides copy-paste-ready Mermaid code (Swimlane, Feedback Loop, Hub and Spoke patterns), concrete ❌/✅ syntax examples, specific config keys, and exact color hex values — fully executable guidance.	3 / 3
Workflow Clarity	A clear 5-step Workflow with an explicit 'Test for common errors' checkpoint and a pre-output Quality Checklist provides a sequenced process with verification, matching the score-3 anchor's checklist pattern.	3 / 3
Progressive Disclosure	A well-signaled one-level reference exists (references/syntax-rules.md, linked twice), but the body duplicates those syntax rules inline and retains large inline sections (full color palette, all 6 diagram types, all config options) that read as a manual rather than a lean overview pointing to detail.	2 / 3
	Total	10 / 12 Passed

Description

90%

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

A strong description with an explicit 'Use when' trigger, natural trigger terms, and a clear distinct niche. Its only weakness is that concrete actions are essentially a single verb applied to several output types rather than multiple distinct actions.

Suggestions

Lead with multiple distinct concrete verbs (e.g., 'Generate, style, and troubleshoot Mermaid diagrams from text') to lift specificity from a single action to a comprehensive action list.

Dimension	Reasoning	Score
Specificity	It names the domain ('Mermaid diagrams') and the primary action ('Transform text content into... diagrams') plus supported output types (process flows, architectures, comparisons, mindmaps) and 'built-in syntax error prevention', but relies on a single concrete action verb rather than listing multiple distinct concrete actions like the score-3 anchor (extract/fill/merge).	2 / 3
Completeness	It explicitly answers both 'what' ('Transform text content into professional Mermaid diagrams...') and 'when' with an explicit 'Use when...' trigger clause, matching the score-3 anchor pattern.	3 / 3
Trigger Term Quality	The 'Use when users ask to visualize concepts, create flowcharts, or make diagrams from text' clause covers natural phrasings a user would actually say (visualize, flowcharts, diagrams), giving good trigger coverage.	3 / 3
Distinctiveness Conflict Risk	The 'Mermaid diagrams' niche with diagram-specific triggers (visualize/flowcharts/diagrams) is clearly distinguishable and unlikely to fire for unrelated skills.	3 / 3
	Total	11 / 12 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: breferrari/obsidian-mind
Path: .claude/skills/mermaid-visualizer/SKILL.md
Commit: aa16349

Reviewed: about 16 hours 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.