mermaid-class-diagram-generator
Install with Tessl CLI
npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill mermaid-class-diagram-generatorMermaid Class Diagram Generator - Auto-activating skill for Visual Content. Triggers on: mermaid class diagram generator, mermaid class diagram 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, essentially just restating the skill name without explaining capabilities or providing meaningful trigger guidance. It lacks concrete actions, natural user keywords, and explicit usage conditions. The redundant trigger terms and missing 'Use when...' clause make it nearly useless for skill selection among multiple options.
Suggestions
Add specific actions the skill performs, e.g., 'Generates Mermaid syntax class diagrams from code, showing inheritance, relationships, and class members.'
Include a 'Use when...' clause with natural trigger terms like 'class diagram', 'UML', 'visualize code structure', 'show class relationships', 'inheritance diagram'.
Remove the redundant duplicate trigger term and expand to include variations users would naturally say when needing this functionality.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only names the tool type ('Mermaid Class Diagram Generator') but provides no concrete actions. It doesn't explain what the skill actually does - no verbs describing capabilities like 'generates', 'creates', 'converts', etc. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond the name, and has no explicit 'Use when...' clause. The 'Triggers on' section is not a proper when-to-use guidance - it just repeats the skill name. | 1 / 3 |
Trigger Term Quality | The trigger terms are redundant (same phrase repeated twice: 'mermaid class diagram generator') and overly specific. Missing natural variations users would say like 'class diagram', 'UML diagram', 'visualize classes', 'code structure diagram', etc. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of 'Mermaid' and 'Class Diagram' provides some specificity that distinguishes it from generic diagram tools, but 'Visual Content' category is vague and could overlap with other visualization skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%This skill content is essentially a placeholder template with no actual instructional value. It describes what a skill should do rather than providing any concrete guidance on Mermaid class diagram syntax, structure, or best practices. The content fails on all dimensions by being verbose yet empty of actionable information.
Suggestions
Add executable Mermaid class diagram code examples showing basic syntax (class definitions, relationships, visibility modifiers)
Include concrete examples of common class diagram patterns (inheritance, composition, interfaces) with copy-paste ready Mermaid code
Remove all generic boilerplate sections (Purpose, When to Use, Capabilities, Example Triggers) and replace with actual Mermaid syntax reference
Add a quick reference section showing relationship notation (--|>, ..|>, -->, etc.) with brief explanations
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is padded with generic boilerplate that provides no actual value. Phrases like 'provides automated assistance' and 'follows industry best practices' are meaningless filler that Claude doesn't need. | 1 / 3 |
Actionability | There is zero concrete guidance on how to actually create Mermaid class diagrams. No syntax examples, no code, no specific commands - just vague descriptions of what the skill supposedly does. | 1 / 3 |
Workflow Clarity | No workflow is provided whatsoever. The skill claims to provide 'step-by-step guidance' but contains no actual steps for creating class diagrams. | 1 / 3 |
Progressive Disclosure | The content is a monolithic block of generic text with no structure pointing to detailed materials, no examples, and no references to additional resources for Mermaid syntax or class diagram patterns. | 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.