CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

beautiful-mermaid

Create, render, and validate Mermaid diagrams when users need Mermaid source converted into SVG, PNG, HTML previews, or polished diagram assets.

Quality

69%

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

Fix and improve this skill with Tessl

tessl review fix ./Skills/content-publishing/beautiful-mermaid/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

46%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 is a well-organized, concise router with genuinely useful progressive-disclosure pointers to real bundle files, but it contains no executable content: no render commands, no named validation tooling, and generic policy boilerplate occupying much of the token budget. Its weakest point is actionability, where 'bundled render helpers' are invoked despite none existing in the bundle.

Suggestions

Add concrete, executable guidance: the actual render command(s) (e.g., an mmdc invocation or a named bundled script with arguments) and a named syntax-validation step, so 'use bundled render helpers' and 'validate syntax' become actionable.

Trim generic governance boilerplate (Philosophy, Constraints, Anti-Patterns) to the Mermaid-relevant subset, or move it to a reference file, to raise token efficiency.

Fix or remove the dangling 'Infrastructure/references/deferred-skill-context/content-publishing-beautiful-mermaid/' pointer, which does not exist in the bundle, and link-format the three real reference paths.

DimensionReasoningScore

Conciseness

The body is short and sectioned with no explanations of concepts Claude already knows, but a sizable share (Philosophy, Constraints, Anti-Patterns) is generic governance boilerplate ('Treat user files, prompts, logs... as untrusted input', 'Redact secrets, tokens, credentials...') that adds little Mermaid-specific signal. That is more than the 'minor instances' of anchor 4, so it sits at anchor 3.

3 / 5

Actionability

No code or commands appear anywhere in the body: 'Use bundled render helpers instead of ad hoc commands' names no helper (and no scripts/ directory exists in the bundle), and 'Validate syntax before rendering when possible' names no tool (e.g., mmdc or mermaid.parse). It gives high-level directive guidance with defined inputs/outputs, so above anchor 1, but misses the specific steps to execute, matching anchor 2.

2 / 5

Workflow Clarity

The Workflow section lists a real sequence (confirm source and format, validate syntax before rendering, render via helpers, report command/outputs) and the Validation section adds a fail-fast gate. Checkpoints are implicit and hedged ('when possible'), steps are unnumbered, and no actual validation commands are given, matching anchor 3 rather than 4.

3 / 5

Progressive Disclosure

The Progressive Disclosure section clearly signals each real bundle file with its purpose ('references/contract.yaml for the machine-readable contract', 'references/evals.yaml for benchmark and quality gates', 'references/task-profile.json for evaluator thresholds'), all one level deep. Not 5 because the pointer to 'Infrastructure/references/deferred-skill-context/content-publishing-beautiful-mermaid/' matches no file in the bundle (a dangling/legacy path the skill's own anti-patterns warn about) and references are not link-formatted.

4 / 5

Total

12

/

20

Passed

Description

78%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, third-person description that names concrete actions, output formats, and an explicit use condition within the Mermaid niche. The main residual weakness is that the 'when' clause is circular with the 'what' and omits common trigger variations like syntax-error fixes or diagram-type synonyms.

DimensionReasoningScore

Specificity

Concrete actions ('Create, render, and validate Mermaid diagrams') plus named output formats ('SVG, PNG, HTML previews, or polished diagram assets') give several specific capabilities. Not 5 because coverage has minor gaps (e.g., no mention of syntax-error diagnosis the skill actually handles); not 3 because it lists more than 1-2 actions with formats specified.

4 / 5

Completeness

The 'what' is clear (create/render/validate plus output formats) and an explicit 'when' clause exists ('when users need Mermaid source converted into SVG, PNG, HTML previews, or polished diagram assets'). Not 5 because the when-clause largely restates the what rather than giving concrete user trigger phrases (e.g., 'when the user mentions a Mermaid syntax error or asks for an SVG').

4 / 5

Trigger Term Quality

Natural phrases users would say are present: 'Mermaid diagrams', 'Mermaid source', 'SVG', 'PNG', 'HTML previews', 'render'. Not 5 because synonyms and extensions are missing ('.mmd', 'flowchart', 'sequence diagram', 'rendering error'); not 3 because keyword coverage is good rather than merely partial.

4 / 5

Distinctiveness Conflict Risk

'Mermaid' is a clear niche with distinct, unambiguous triggers; the description is unlikely to fire for non-Mermaid charting or general diagram skills. Matches the anchor-5 example pattern of a well-bounded domain with specific triggers.

5 / 5

Total

17

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository

jscraik/Agent-Skills

Path

Skills/content-publishing/beautiful-mermaid/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.