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

79%

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 ./plugins/beautiful-mermaid/skills/SKILL.md

Quality

Content

76%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 content is highly actionable and well-structured with a proper external reference, but the workflow lacks validation checkpoints around its destructive cleanup step. Minor conciseness and organization gaps remain.

Suggestions

Add a validation checkpoint before Step 5 cleanup (e.g. confirm <output>.svg is non-empty and <output>.png was captured successfully) and only delete intermediaries once both final outputs are verified.

De-duplicate the edge-label pipe-notation guidance, which appears in both 'Common Syntax Patterns' and 'Troubleshooting — Diagram appears cut off or incomplete'.

Consider moving the 13-row Theme Selection Guide table into references/ (e.g. references/themes.md) to keep SKILL.md a tighter overview, retaining only the default-theme note inline.

Dimension	Reasoning	Score
Conciseness	The body is lean and assumes Claude's competence (no 'what is Mermaid' padding), with executable commands throughout; minor redundancy (edge-label pipe guidance appears in both Common Syntax Patterns and Troubleshooting) keeps it off a 5.	4 / 5
Actionability	Provides fully executable, copy-paste-ready commands (e.g. 'bun run scripts/render.ts --code "..." --output diagram --theme default' and the agent-browser sequence) covering the common code-input and file-input cases.	5 / 5
Workflow Clarity	Five steps are clearly sequenced, but there are no validation checkpoints; Step 5 performs destructive cleanup of intermediary files without first verifying the final SVG/PNG exist and are valid, which caps this dimension at 3 per the rubric.	3 / 5
Progressive Disclosure	Clear overview with a well-signaled one-level-deep reference ('Consult references/mermaid-syntax.md for full syntax details', verified present); some inline reference material (the 13-row theme table) could live in a separate file, so not a 5.	4 / 5
	Total	16 / 20 Passed

Description

82%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.

The description is concise and cleanly answers both what and when with a natural trigger phrase and a distinct niche. Its only gap is modest action coverage and a few missing synonyms/extensions.

Dimension	Reasoning	Score
Specificity	Quotes 'Render Mermaid diagrams as SVG and PNG' — names the domain plus two concrete output actions, matching the '1-2 concrete actions but not comprehensive' anchor; it is not a 4 because no additional actions (e.g. theming, HTML wrapping) are surfaced.	3 / 5
Completeness	Explicitly states what ('Render Mermaid diagrams as SVG and PNG using the Beautiful Mermaid library') and when ('Use when the user asks to render a Mermaid diagram') with a concrete trigger phrase, matching the top anchor.	5 / 5
Trigger Term Quality	Includes the natural phrase 'render a Mermaid diagram' plus 'SVG and PNG'; good keyword coverage but missing common synonyms like 'flowchart' or the '.mmd' extension, so not a 5.	4 / 5
Distinctiveness Conflict Risk	Targets a clear niche (Mermaid diagram rendering via a named library) with distinct triggers and minimal overlap with other skills.	5 / 5
	Total	17 / 20 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
referenced_paths_exist	Referenced path issues: 5 missing	Warning

	Total	15 / 16 Passed

Repository: intellectronica/agent-skills
Path: plugins/beautiful-mermaid/skills/SKILL.md
Commit: 9b0e00a

Reviewed: 2 days 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.