mermaid-flowchart-generator
Mermaid Flowchart Generator - Auto-activating skill for Visual Content. Triggers on: mermaid flowchart generator, mermaid flowchart generator Part of the Visual Content skill category.
34
3%
Does it follow best practices?
Impact
87%
1.00xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./planned-skills/generated/18-visual-content/mermaid-flowchart-generator/SKILL.mdQuality
Discovery
7%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 description is essentially a title restated with no substantive content. It fails to describe concrete capabilities, lacks natural trigger terms users would use, and provides no explicit guidance on when Claude should select this skill. It reads like auto-generated boilerplate rather than a useful skill description.
Suggestions
Add specific concrete actions such as 'Generates Mermaid flowchart syntax from process descriptions, decision trees, and workflow diagrams' to clarify what the skill does.
Add a 'Use when...' clause with natural trigger terms like 'Use when the user asks for a flowchart, diagram, process flow, decision tree, or mentions Mermaid syntax, .mmd files, or visual workflow representation.'
Remove the duplicate trigger term and expand with varied natural language terms users might say, such as 'diagram', 'flow diagram', 'process chart', 'visualize steps', 'mermaid code'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain ('Mermaid Flowchart Generator') but does not describe any concrete actions. There are no specific capabilities listed such as 'creates flowcharts from text descriptions' or 'converts process steps into Mermaid syntax'. | 1 / 3 |
Completeness | The description barely answers 'what does this do' beyond restating the skill name, and there is no explicit 'when to use' guidance. The 'Triggers on' line is just a duplicate of the title, not meaningful trigger guidance. | 1 / 3 |
Trigger Term Quality | The trigger terms are just the skill name repeated twice ('mermaid flowchart generator, mermaid flowchart generator'). It misses natural user phrases like 'diagram', 'flow diagram', 'process chart', 'mermaid syntax', 'mermaid diagram', or 'visualize workflow'. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of 'Mermaid Flowchart' provides some specificity that distinguishes it from generic diagramming or visualization skills, but the lack of detail about what it actually does and the vague 'Visual Content' category could cause overlap with other diagram or chart skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a completely empty placeholder skill with no actual content. It contains only generic boilerplate text that repeats the skill name without providing any Mermaid syntax, flowchart examples, best practices, or actionable guidance. It would be more harmful than helpful as it wastes context window tokens while teaching Claude nothing.
Suggestions
Add concrete Mermaid flowchart syntax examples with executable code blocks (e.g., `graph TD; A-->B; B-->C;`) covering common patterns like decision trees, sequential flows, and subgraphs.
Replace the generic 'Capabilities' and 'Example Triggers' sections with actual step-by-step instructions for creating flowcharts, including node types, edge styles, and styling options.
Include at least 2-3 complete input/output examples showing a user requirement and the corresponding Mermaid diagram code.
Add a validation step or checklist for common Mermaid syntax errors (e.g., reserved characters, missing semicolons, invalid node IDs) to ensure generated diagrams render correctly.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is entirely filler and boilerplate. It explains nothing Claude doesn't already know, repeats 'mermaid flowchart generator' excessively, and provides zero actual information about how to generate Mermaid flowcharts. | 1 / 3 |
Actionability | There is no concrete guidance whatsoever—no Mermaid syntax examples, no code snippets, no commands, no specific instructions. Every section is vague and abstract, describing what the skill supposedly does without actually doing it. | 1 / 3 |
Workflow Clarity | No workflow is defined. The skill claims to provide 'step-by-step guidance' but contains zero steps. There are no sequences, no validation checkpoints, and no process to follow. | 1 / 3 |
Progressive Disclosure | The content is a monolithic block of generic placeholder text with no meaningful structure, no references to detailed materials, and no navigation to additional resources. The sections that exist contain no substantive content. | 1 / 3 |
Total | 4 / 12 Passed |
Validation
81%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 9 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 9 / 11 Passed | |
- Commit
4dee593
- 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.