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.

5.64x

Quality

86%

Does it follow best practices?

Impact

96%

5.64x

Average score across 3 eval scenarios

Securityby

Passed

No known issues

Quality

Content

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

Description

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

Validation

100%

Warnings & errors only

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: 4 months ago

Table of Contents

Discovery Implementation Validation

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.