beautiful-mermaid

Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library. Use when the user asks to render a Mermaid diagram.

Quality

80%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./.agents/skills/beautiful-mermaid/SKILL.md

Quality

Content

85%

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

The content is highly actionable with a clear sequenced workflow and well-structured one-level-deep references to genuine bundle files. The main weakness is mild token redundancy from duplicate theme listings and optional runtime variants, which keeps conciseness below the top anchor.

Suggestions

Collapse the duplicated theme listing: keep the Theme Selection Guide table and drop or drastically shorten the inline prose list at line 24 to remove redundant tokens.

Move the 'Alternative runtimes' (npx tsx / deno) variants into references/mermaid-syntax.md or omit them, since the primary bun invocation already covers the common path.

Dimension	Reasoning	Score
Conciseness	The body is lean and avoids explaining concepts Claude already knows, but the theme list appears twice (prose at line 24 and the full Theme Selection Guide table) and the 'Alternative runtimes' block adds tokens that could be trimmed.	2 / 3
Actionability	Every step ships copy-paste-ready, executable commands with concrete flags (e.g., 'bun run scripts/render.ts --code ... --theme default' and 'agent-browser screenshot --full diagram.png'), matching the fully-executable top anchor.	3 / 3
Workflow Clarity	A clearly numbered five-step sequence pairs with an explicit error-recovery section (Troubleshooting: validate at mermaid.live, check edge-label syntax) providing the feedback loops the top anchor rewards.	3 / 3
Progressive Disclosure	The body is an overview that signals one-level-deep references to the real files references/mermaid-syntax.md and the scripts/render.ts and scripts/create-html.ts bundle files, with syntax detail appropriately offloaded rather than inlined.	3 / 3
	Total	11 / 12 Passed

Description

75%

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

The description clearly answers what and when with a distinct, low-conflict trigger, but its action list and trigger-term coverage are narrower than the top anchor. Adding more concrete verbs and natural variations (diagram types, file formats) would raise specificity and trigger_term_quality.

Suggestions

Add more concrete verbs beyond 'Render' (e.g., 'Generate, render, and export Mermaid diagrams') to reach the specificity top anchor.

Broaden trigger terms with natural variations like 'flowchart', 'sequence diagram', 'state diagram', or '.mmd/.svg/.png' so the description matches how users actually phrase the request.

Dimension	Reasoning	Score
Specificity	Names the domain (Mermaid diagrams) and two concrete output formats (SVG, PNG) but uses a single verb ('Render'), so it lists some actions rather than the multiple distinct actions the top anchor requires.	2 / 3
Completeness	Explicitly states what it does ('Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library') and when to use it ('Use when the user asks to render a Mermaid diagram'), satisfying both halves of the top anchor.	3 / 3
Trigger Term Quality	'Mermaid diagrams' and 'render a Mermaid diagram' are natural user terms, but coverage misses common variations like 'flowchart', 'sequence diagram', 'diagram to image', or the .svg/.png/.mmd file formats.	2 / 3
Distinctiveness Conflict Risk	The Mermaid-rendering niche is narrow with a distinct, library-specific trigger, making it unlikely to fire for unrelated skills.	3 / 3
	Total	10 / 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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository: calesthio/OpenMontage
Path: .agents/skills/beautiful-mermaid/SKILL.md
Commit: 0af32ce

Reviewed: 1 day 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.