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

92%

Does it follow best practices?

Impact

—

No eval scenarios have been run

Securityby

Passed

No known issues

Quality

Content

85%

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

This is a well-structured, actionable skill with excellent workflow clarity and progressive disclosure. The concrete syntax examples with wrong/right patterns are particularly valuable. The main weakness is moderate verbosity in diagram type descriptions and configuration options that could be tightened without losing clarity.

Suggestions

Condense the Diagram Types section by removing explanatory phrases like 'Best for:' and 'Use when:' - Claude can infer appropriate usage from the type names and key features

Move the detailed Color Scheme Defaults section to the referenced syntax-rules.md file, keeping only a brief mention that semantic colors are used

Dimension	Reasoning	Score
Conciseness	The skill is reasonably efficient but includes some unnecessary explanation (e.g., the Overview section restates what Mermaid is, and some diagram type descriptions are verbose). The configuration options and color scheme sections could be more compact.	2 / 3
Actionability	Provides concrete, executable Mermaid code examples throughout. The Critical Syntax Rules section shows exact wrong/right patterns, and the Common Patterns section offers copy-paste ready templates.	3 / 3
Workflow Clarity	Clear 5-step workflow with explicit validation via the Quality Checklist at the end. The numbered steps in both Quick Start and Workflow sections provide unambiguous sequencing with specific checkpoints for error prevention.	3 / 3
Progressive Disclosure	Well-structured with clear sections progressing from Quick Start to detailed configuration. References external file (references/syntax-rules.md) for complete syntax details, keeping the main skill focused on essential guidance.	3 / 3
	Total	11 / 12 Passed

Description

100%

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

This is a strong skill description that clearly communicates capabilities, use cases, and triggers. It uses third person voice correctly, lists specific diagram types supported, and includes an explicit 'Use when...' clause with natural trigger terms. The description is concise yet comprehensive, making it easy for Claude to select this skill appropriately.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'Transform text content into professional Mermaid diagrams', 'visualize concepts', 'create flowcharts', 'make diagrams'. Also specifies supported diagram types: 'process flows, system architectures, comparisons, mindmaps' and mentions 'built-in syntax error prevention'.	3 / 3
Completeness	Clearly answers both what ('Transform text content into professional Mermaid diagrams... Supports process flows, system architectures, comparisons, mindmaps') AND when ('Use when users ask to visualize concepts, create flowcharts, or make diagrams from text') with explicit trigger guidance.	3 / 3
Trigger Term Quality	Includes natural keywords users would say: 'visualize concepts', 'create flowcharts', 'make diagrams', 'Mermaid diagrams', 'presentations', 'documentation', 'process flows', 'system architectures', 'mindmaps'. Good coverage of terms users naturally use when requesting diagram creation.	3 / 3
Distinctiveness Conflict Risk	Clear niche focused specifically on Mermaid diagrams with distinct triggers like 'Mermaid', 'flowcharts', 'visualize concepts', 'diagrams from text'. The Mermaid-specific focus and diagram type enumeration make it unlikely to conflict with general documentation or other visualization skills.	3 / 3
	Total	12 / 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 — 11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository: axtonliu/axton-obsidian-visual-skills
Commit: 1265976

Reviewed: 4 months 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.