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:fernandezbaptiste/claude-code-skills --skill mermaid-tools89
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 clearly defines specific capabilities (extracting Mermaid diagrams, generating PNGs) and provides explicit activation triggers. It uses third person voice correctly and includes natural keywords users would actually use when needing this functionality.
| 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'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'Mermaid diagrams', 'PNG', 'markdown files', 'converting diagrams', 'embedded Mermaid code'. Good coverage of variations. | 3 / 3 |
Distinctiveness Conflict Risk | Very specific niche combining Mermaid diagrams, markdown extraction, and PNG generation. Unlikely to conflict with generic image or markdown skills due to the specific Mermaid focus. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
72%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides actionable, executable guidance with good progressive disclosure to reference materials. However, it suffers from some redundancy (repeated cd commands, duplicated information about bundled scripts) and could better integrate validation checkpoints into the main workflow rather than treating them as separate concerns.
Suggestions
Consolidate the repeated 'cd ~/.claude/skills/mermaid-tools/scripts' instruction into a single note at the beginning rather than repeating it in every code block
Integrate prerequisites verification as step 0 of the Core Workflow rather than a separate section, making it a clear pre-flight checkpoint
Remove the 'Bundled Resources' section as it largely duplicates information already covered in the document
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient but includes some redundancy - the 'cd' command pattern is repeated multiple times, and the 'What the Script Does' section explains behavior Claude could infer. The bundled resources section at the end largely repeats earlier information. | 2 / 3 |
Actionability | Provides fully executable bash commands with clear parameters, concrete examples with actual paths, and copy-paste ready code blocks. Environment variable usage is well-documented with specific values. | 3 / 3 |
Workflow Clarity | The workflow steps are listed but validation is only mentioned as something the script does internally, not as explicit checkpoints for the user. The prerequisites verification section is separate from the main workflow rather than integrated as a pre-flight check. | 2 / 3 |
Progressive Disclosure | Well-structured with clear sections progressing from basic to advanced usage. Appropriately references external documentation (references/setup_and_troubleshooting.md) for detailed setup and troubleshooting without nesting multiple levels deep. | 3 / 3 |
Total | 10 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- 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.