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.
90
86%
Does it follow best practices?
Impact
96%
5.64xAverage score across 3 eval scenarios
Passed
No known issues
Quality
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 communicates specific capabilities (extracting Mermaid diagrams, generating PNGs) and provides explicit activation triggers with natural keyword variations. It uses proper third-person voice and occupies a distinct niche that minimizes conflict risk 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.' These are clear, actionable capabilities. | 3 / 3 |
Completeness | Clearly answers both 'what' (extracts Mermaid diagrams, generates PNG images) and 'when' ('Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code'). | 3 / 3 |
Trigger Term Quality | Includes strong natural keywords users would say: 'Mermaid diagrams', 'PNG', 'markdown files', 'converting diagrams to PNG', 'extracting diagrams from markdown', 'embedded Mermaid code'. Good coverage of variations. | 3 / 3 |
Distinctiveness Conflict Risk | Very clear niche targeting Mermaid diagram extraction and PNG rendering from markdown. The combination of Mermaid + markdown + PNG is highly specific and unlikely to conflict with other skills. | 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 is a reasonably well-structured skill with strong actionability and good progressive disclosure to reference files. Its main weaknesses are repetitive command prefixes and some unnecessary explanatory content that could be trimmed. The workflow is straightforward but could benefit from explicit validation/error-handling guidance integrated into the main flow.
Suggestions
Reduce repetition by defining the script directory path once at the top (e.g., 'All commands below assume you've run `cd ~/.claude/skills/mermaid-tools/scripts` first') instead of repeating it in every code block.
Remove the 'Overview' paragraph and 'What the Script Does' enumeration—the command usage and output files section already convey this information more efficiently.
Integrate prerequisite verification as step 1 of the core workflow with a clear 'if missing, stop and see references' checkpoint rather than listing it as a separate section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content has some unnecessary repetition—the 'cd ~/.claude/skills/mermaid-tools/scripts' command is repeated 7 times, and sections like 'What the Script Does' and 'Bundled Resources' explain things Claude doesn't need spelled out. The overview paragraph restates the description. However, it's not egregiously verbose. | 2 / 3 |
Actionability | The skill provides fully executable bash commands with concrete parameters, environment variable overrides, and specific examples. Commands are copy-paste ready with clear parameter descriptions. | 3 / 3 |
Workflow Clarity | The core workflow is a single command invocation which is clear, but the 'What the Script Does' section describes internal steps without explicit user validation checkpoints. The prerequisites verification is listed but not integrated into the workflow as a pre-check step. There's no explicit feedback loop for handling failures during generation. | 2 / 3 |
Progressive Disclosure | Content is well-structured with clear sections progressing from core usage to advanced options. Troubleshooting and setup details are appropriately delegated to 'references/setup_and_troubleshooting.md' with clear signaling, maintaining one-level-deep references. | 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.
- Repository
- fernandezbaptiste/claude-code-skills
- Commit
4f0eae8
- 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.