mermaid-state-diagram-creator
Install with Tessl CLI
npx tessl i github:jeremylongshore/claude-code-plugins-plus-skills --skill mermaid-state-diagram-creatorMermaid State Diagram Creator - Auto-activating skill for Visual Content. Triggers on: mermaid state diagram creator, mermaid state diagram creator 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, consisting primarily of the skill name and category metadata without any substantive content. It fails to describe what actions the skill performs, provides no natural trigger terms users would use, and lacks any guidance on when Claude should select this skill. The duplicate trigger term suggests a copy-paste error.
Suggestions
Add specific actions the skill performs, e.g., 'Creates Mermaid state diagrams showing states, transitions, and conditions. Converts process flows into state machine notation.'
Include a 'Use when...' clause with natural trigger terms like 'state machine', 'state diagram', 'transitions', 'mermaid syntax', 'visualize states', or when users describe workflows with states.
Remove the duplicate trigger term and expand with variations users would naturally say, such as 'state chart', 'FSM diagram', 'state flow'.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description only names the tool ('Mermaid State Diagram Creator') without describing any concrete actions. There are no verbs indicating what the skill actually does - no mention of creating, editing, converting, or any specific capabilities. | 1 / 3 |
Completeness | The description fails to answer 'what does this do' beyond the name, and provides no 'when should Claude use it' guidance. There is no 'Use when...' clause or equivalent explicit trigger guidance. | 1 / 3 |
Trigger Term Quality | The trigger terms are just the skill name repeated twice ('mermaid state diagram creator, mermaid state diagram creator'). Missing natural variations users would say like 'state machine', 'flowchart', 'diagram states', 'transitions', or file extensions. | 1 / 3 |
Distinctiveness Conflict Risk | The mention of 'Mermaid State Diagram' provides some specificity that distinguishes it from generic diagram tools, but 'Visual Content skill category' is vague and could overlap with many other visualization skills. | 2 / 3 |
Total | 5 / 12 Passed |
Implementation
0%This skill is essentially a placeholder template with no actual content about Mermaid state diagrams. It contains only generic boilerplate text that could apply to any skill, with no executable code, syntax examples, or concrete guidance. The skill fails to teach Claude anything about creating state diagrams in Mermaid.
Suggestions
Add executable Mermaid state diagram code examples showing basic syntax (stateDiagram-v2, states, transitions, start/end nodes)
Include concrete examples of common state diagram patterns (e.g., login flow, order processing, traffic light)
Provide the actual Mermaid state diagram syntax reference (state declarations, transitions with -->>, notes, composite states)
Remove all generic boilerplate text ('provides automated assistance', 'follows industry best practices') and replace with actionable content
| 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 no actual information about Mermaid state diagrams. | 1 / 3 |
Actionability | There is zero concrete guidance on how to create Mermaid state diagrams. No syntax examples, no code snippets, no actual state diagram patterns - 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 state diagrams. | 1 / 3 |
Progressive Disclosure | The content is a monolithic block of generic text with no structure pointing to useful resources, examples, or reference materials. No links to Mermaid documentation or related files. | 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.