mermaid-flowchart-generator
Install with Tessl CLI
npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill mermaid-flowchart-generatorMermaid Flowchart Generator - Auto-activating skill for Visual Content. Triggers on: mermaid flowchart generator, mermaid flowchart generator Part of the Visual Content skill category.
Overall
score
19%
Does it follow best practices?
Validation for skill structure
Activation
7%This description is severely underdeveloped, functioning more as a label than a useful skill description. It lacks concrete actions, meaningful trigger terms, and explicit usage guidance. The redundant trigger terms and boilerplate category mention provide almost no value for skill selection.
Suggestions
Add specific actions the skill performs, e.g., 'Generates Mermaid syntax flowcharts from process descriptions, converts workflows to visual diagrams, creates decision trees and sequence flows.'
Include a proper 'Use when...' clause with natural trigger terms: 'Use when the user asks for flowcharts, process diagrams, decision trees, workflow visualization, or mentions Mermaid syntax.'
Add common user phrases and file/format references: 'flowchart', 'diagram', 'process flow', 'visualize steps', 'mermaid code', '.mmd files'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only names the tool ('Mermaid Flowchart Generator') without describing any concrete actions. It doesn't explain what the skill actually does - no verbs like 'creates', 'generates', 'converts', etc. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond the name, and provides no explicit 'when to use' guidance. The 'Triggers on' section is not a proper 'Use when...' clause and just repeats the skill name. | 1 / 3 |
Trigger Term Quality | The trigger terms are redundant ('mermaid flowchart generator' listed twice) and overly specific. Missing natural variations users would say like 'flowchart', 'diagram', 'flow diagram', 'process flow', 'mermaid diagram', or 'visualize workflow'. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of 'Mermaid' and 'Flowchart' provides some specificity that distinguishes it from generic diagram tools, but 'Visual Content skill category' is vague and could overlap with other visualization skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%This skill is an empty template with no actual content about Mermaid flowcharts. It contains only meta-descriptions of what a skill should do without any Mermaid syntax, flowchart examples, node types, edge definitions, or styling guidance. The skill provides zero value over Claude's baseline knowledge.
Suggestions
Add actual Mermaid flowchart syntax with executable examples (e.g., `graph TD; A-->B;`)
Include common flowchart patterns: decision trees, process flows, swimlanes with copy-paste ready code
Provide node shape syntax (rectangles, diamonds, circles) and edge styling options
Remove all generic boilerplate sections (Purpose, When to Use, Capabilities) and replace with concrete reference material
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic boilerplate that explains nothing Claude doesn't already know. Phrases like 'provides automated assistance' and 'follows industry best practices' are meaningless filler with zero actionable information. | 1 / 3 |
Actionability | Contains no concrete guidance whatsoever - no Mermaid syntax, no code examples, no actual flowchart patterns. The entire skill describes what it does rather than instructing how to do anything. | 1 / 3 |
Workflow Clarity | No workflow is defined. Claims to provide 'step-by-step guidance' but contains zero steps. There's no sequence, no validation, and no actual process for creating Mermaid flowcharts. | 1 / 3 |
Progressive Disclosure | No useful structure - just generic sections with no real content. No references to detailed materials, examples, or syntax guides. The 'Related Skills' section adds no navigational value. | 1 / 3 |
Total | 4 / 12 Passed |
Validation
69%Validation — 11 / 16 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
description_trigger_hint | Description may be missing an explicit 'when to use' trigger hint (e.g., 'Use when...') | Warning |
allowed_tools_field | 'allowed-tools' contains unusual tool name(s) | Warning |
metadata_version | 'metadata' field is not a dictionary | Warning |
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
body_steps | No step-by-step structure detected (no ordered list); consider adding a simple workflow | Warning |
Total | 11 / 16 Passed | |
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.