mermaid-tools
Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts. Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code.
Install with Tessl CLI
npx tessl i github:daymade/claude-code-skills --skill mermaid-toolsOverall
score
85%
Does it follow best practices?
If you maintain this skill, you can automatically optimize it using the tessl CLI to improve its score:
npx tessl skill review --optimize ./path/to/skillValidation 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 well-crafted skill description that excels across all dimensions. It clearly specifies concrete actions (extract and generate), includes natural trigger terms users would say, explicitly states when to activate, and occupies a distinct niche that won't conflict with other skills.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Extracts Mermaid diagrams from markdown files' and 'generates high-quality PNG images using bundled scripts'. Clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both what ('Extracts Mermaid diagrams...generates high-quality PNG images') and when ('Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown...'). Explicit trigger guidance provided. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms: 'Mermaid diagrams', 'PNG', 'markdown files', 'converting diagrams to PNG', 'extracting diagrams', 'embedded Mermaid code'. These are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche combining Mermaid diagrams + markdown + PNG generation. Unlikely to conflict with generic image or markdown skills due to the specific Mermaid focus. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
73%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides solid, actionable guidance with executable commands and good progressive disclosure to reference materials. The main weaknesses are some redundancy in repeating the cd/script path pattern and missing explicit validation/error recovery steps in the workflow. The content would benefit from consolidating repeated instructions and adding clearer feedback loops for error handling.
Suggestions
Consolidate the repeated 'cd ~/.claude/skills/mermaid-tools/scripts' instruction into a single note at the top rather than repeating it in every code block
Add explicit validation steps after PNG generation (e.g., 'Verify output: ls -la <output_directory>/*.png' and what to check for)
Include a brief error recovery workflow: what to do if the script fails, how to interpret error messages, and when to consult the troubleshooting reference
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundancy - the 'cd' command and script path are repeated multiple times, and the 'What the Script Does' section explains behavior Claude could infer from the script name and parameters. | 2 / 3 |
Actionability | Provides fully executable bash commands with clear parameters, concrete examples with actual paths, and specific environment variable configurations for different use cases (presentations, print-quality). | 3 / 3 |
Workflow Clarity | The workflow is clear with numbered steps in 'What the Script Does', but lacks explicit validation checkpoints - the script 'validates all generated PNG files' but there's no guidance on what to do if validation fails or how to verify success. | 2 / 3 |
Progressive Disclosure | Well-structured with clear sections progressing from core workflow to advanced usage, appropriately references external documentation (references/setup_and_troubleshooting.md) for detailed setup and troubleshooting without nesting. | 3 / 3 |
Total | 10 / 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 — 13 / 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 |
metadata_version | 'metadata' field is not a dictionary | Warning |
license_field | 'license' field is missing | Warning |
Total | 13 / 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.