CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The body delivers fully executable guidance with a clear prerequisites-then-run workflow and an exemplary one-level-deep reference split. Its main weakness is verbosity: the same command block and script listings are repeated across redundant sections (Example, Important Principles, Bundled Resources), inflating token cost without adding information. Trimming the duplication would raise every dimension's clarity.

Suggestions

Delete the 'Example' section under Standard Diagram Extraction — it duplicates the preceding usage block verbatim — and show the full invocation only once, referring back to it from Advanced Usage and Troubleshooting instead of repeating it.

Collapse 'Important Principles' and 'Bundled Resources' into a one-line note in Core Workflow (e.g., 'Run from ${CLAUDE_SKILL_DIR}/scripts so bundled dependencies resolve'); both sections restate the Overview's content.

Move the Smart Sizing table and the environment-variable defaults detail into references/setup_and_troubleshooting.md, keeping only a one-line pointer, since they are reference material rather than core workflow.

DimensionReasoningScore

Conciseness

Several padded, redundant sections: the 'Example' block is identical to the usage block above it; 'Important Principles' (Use Bundled Scripts / Change to Script Directory) restates instructions and the same command already given in Core Workflow; 'Bundled Resources' repeats the Overview's script listing; and the identical four-line invocation `cd "${CLAUDE_SKILL_DIR}/scripts" ./extract-and-generate.sh ...` appears five times. This matches anchor 2 ('several unnecessary explanations or padded sections') — the body could be cut by roughly 40% with no loss; it is not anchor 3 because the redundancy is extensive rather than 'some' tightening, though it never explains concepts Claude already knows, keeping it above 1.

2 / 5

Actionability

Fully executable, copy-paste-ready commands throughout: the exact script invocation with parameters and defaults, environment-variable overrides (`MERMAID_WIDTH=1600 MERMAID_HEIGHT=1200`), prerequisite checks (`mmdc --version`, `google-chrome-stable --version`), and a `chmod +x` fix. Specific examples cover the common cases (standard, presentation, print quality, troubleshooting). Not below 5 because no pseudocode or missing key details were found.

5 / 5

Workflow Clarity

The sequence is clear — verify prerequisites (three explicit version checks), run the script, and the script itself 'Validates all generated PNG files', with a Troubleshooting section for error recovery. This lands at anchor 4 ('clear sequence with most checkpoints present; minor validation gaps'): not 5 because there is no explicit post-run verify-and-retry loop instructed to Claude (validation is stated as script-internal, and error handling is deferred to the reference file); not 3 because prerequisite verification and stated output validation are present, so checkpoints are not merely implicit.

4 / 5

Progressive Disclosure

Appropriate split verified against the actual bundle: SKILL.md holds usage, while setup, installation, and deep troubleshooting live one level deep in references/setup_and_troubleshooting.md (a real file), clearly signaled twice ('consult references/... for installation instructions', 'Load this reference when dealing with setup issues...') with a bulleted list of what it covers. The three bundled scripts exist and are listed. Not 4 because no content that clearly belongs in the reference is inlined at length, and navigation is easy; not below 5 since references are one level deep and well signaled.

5 / 5

Total

16

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it pairs a clear third-person statement of the two concrete actions with an explicit, multi-variation activation clause. Trigger coverage is natural and the Mermaid niche is unmistakable. Minor room to grow by mentioning output customization and file extensions like .mmd.

DimensionReasoningScore

Specificity

Concrete actions are stated: 'Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts' — two specific actions that fully cover this narrow skill's scope. Not a 5 because it lists only two actions ('several' anchors expect 3+) and omits capabilities the body documents, like custom sizing/scaling; not a 3 because the coverage is comprehensive for what the skill actually does, exceeding '1-2 concrete actions, but not comprehensive'.

4 / 5

Completeness

Explicitly answers both: what ('Extracts Mermaid diagrams from markdown files and generates high-quality PNG images using bundled scripts') and when ('Activates when working with Mermaid diagrams, converting diagrams to PNG, extracting diagrams from markdown, or processing markdown files with embedded Mermaid code') with concrete trigger phrases. This matches the anchor-5 example structure exactly; a 4 would require the 'when' clause to be less explicit or specific, which it is not.

5 / 5

Trigger Term Quality

Good natural keyword coverage: 'Mermaid diagrams', 'converting diagrams to PNG', 'extracting diagrams from markdown', 'markdown files with embedded Mermaid code' — phrases a user would plausibly say. Not a 5 because file extensions (.mmd, .md) and common synonyms like 'render' or 'export' Mermaid diagrams are missing; not a 3 because it goes well beyond one domain keyword with multiple action-oriented variations.

4 / 5

Distinctiveness Conflict Risk

'Mermaid' is a highly distinctive niche term, and the trigger phrases are anchored to Mermaid/PNG conversion specifically. The broadest phrase ('processing markdown files') is scoped by 'with embedded Mermaid code', keeping conflict risk with generic markdown skills minimal, matching the anchor-5 'clear niche with distinct triggers'.

5 / 5

Total

18

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

daymade/claude-code-skills

Path

daymade-docs/mermaid-tools/SKILL.md

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.