CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

mermaid-diagram

Generate Mermaid diagrams from user requirements. Save .mmd and .md files to figures/ with syntax verification. Supports flowcharts, sequence diagrams, class diagrams, ER diagrams, Gantt charts, and many more diagram types.

Quality

75%

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/skills-codex/mermaid-diagram/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

A strongly actionable, well-sequenced workflow with genuine validation and feedback loops, undermined by monolithic structure and verbosity. Roughly half the file is conditionally-relevant reference material inlined into the always-loaded body, plus injected-looking noise lines and repeated references to "Codex" that don't belong in this skill.

Suggestions

Move the KaTeX math guide, CVPR/ICLR style guide, and architecture-beta layout tips into references/ files (e.g. references/math.md, references/academic-style.md), keeping SKILL.md to the workflow plus one-line pointers loaded per diagram type.

Delete the noise lines ("ASCII alias for automated checks: ...") and replace all "Codex" references with agent-neutral wording; also remove or compress the 23-row diagram-type table, which Claude already knows.

Fix the dangling instructions: either add the promised "Mermaid syntax reference" as a reference file or point "fetch the up-to-date syntax reference" at a concrete source.

DimensionReasoningScore

Conciseness

The core workflow is operational, but the body carries substantial padding Claude does not need: a 23-row diagram-type table, a full KaTeX pattern table, extended academic style/color guidance, and noise lines like "ASCII alias for automated checks: score >= 9." It sits at "mostly efficient but could be tightened" — not 2, because the workflow steps themselves contain little over-explanation of things Claude already knows.

3 / 5

Actionability

Concrete, executable guidance throughout: `mkdir -p figures`, the `mmdc` verification command with an `npx` fallback, a copy-ready review checklist template, kebab-case naming examples, and junction-routing code. Minor gaps keep it below 5: "Read the corresponding Mermaid syntax reference below" points at no actual syntax reference, and "fetch the up-to-date syntax reference" names no source.

4 / 5

Workflow Clarity

Steps 0-6 are explicitly sequenced with a mandatory `mmdc` syntax validation checkpoint, a fix-and-retry loop bounded by MAX_ITERATIONS, a full strict verification checklist, and a defined ACCEPT/FIX verdict gate — exactly the top anchor (explicit validation, feedback loops, checklists). The stray "Codex" naming is an inconsistency, not a sequencing or validation gap.

5 / 5

Progressive Disclosure

No bundle files exist; everything lives inline in one ~380-line SKILL.md, including ~200 lines of conditionally-relevant material (KaTeX math guide, CVPR/ICLR style guide, architecture-beta tips) that belongs in references/ loaded only when needed. Sections are well-headed (above the headerless-inline anchor at 2), but content that clearly should be separate is inline, holding it at 3.

3 / 5

Total

15

/

20

Passed

Description

70%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 specific, third-person description with concrete actions and good natural trigger terms. Its one structural weakness is the complete absence of a "Use when..." clause, leaving the activation conditions implicit and capping completeness.

Suggestions

Append an explicit trigger clause, e.g. "Use when the user asks for diagrams, flowcharts, sequence diagrams, architecture or ER diagrams, or mentions Mermaid."

Mention the rendered PNG output (mmdc render + visual review) so the description covers the full delivered artifact set, not just .mmd/.md.

Add one or two common synonyms users say ("draw a diagram", ".mmd") to broaden natural trigger coverage.

DimensionReasoningScore

Specificity

Quotes concrete actions — "Generate Mermaid diagrams from user requirements", "Save .mmd and .md files to figures/ with syntax verification" — plus an enumerated list of diagram types. Minor gaps (PNG rendering and the review loop are part of the skill but unmentioned), so it does not reach the comprehensive anchor at 5, but it clearly exceeds the 1-2-action anchor at 3.

4 / 5

Completeness

The "what" is clear (generate diagrams, save two file types with syntax verification), but there is no "Use when..." clause or equivalent trigger guidance anywhere in the description, which caps completeness at 3 per the judging guidelines. Not 4, because the "when" is entirely absent rather than merely implicit.

3 / 5

Trigger Term Quality

Natural phrases users would say are present: "Mermaid diagrams", "flowcharts", "sequence diagrams", "ER diagrams", "Gantt charts". A few common variations are missing ("chart", "draw", "visualize", ".mmd"), matching the good-coverage-with-gaps anchor at 4 rather than the comprehensive synonym coverage at 5.

4 / 5

Distinctiveness Conflict Risk

"Mermaid" names a specific tool with a clear niche, and the enumerated diagram types reinforce it; conflict risk with other skills is minimal. The chart-type mentions (pie, XY) create only negligible overlap with generic charting skills, so it holds the top anchor.

5 / 5

Total

16

/

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

wanshuiyin/Auto-claude-code-research-in-sleep

Path

skills/skills-codex/mermaid-diagram/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.