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.
Install with Tessl CLI
npx tessl i github:axtonliu/axton-obsidian-visual-skills --skill mermaid-visualizer93
Does it follow best practices?
Validation for skill structure
Discovery
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 |
Implementation
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 |
Validation
100%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.
- Reviewed
Table of Contents
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.