CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

cli-anything-mermaid

Command-line interface for Mermaid Live Editor - Create, edit, and render Mermaid diagrams via stateful project files and mermaid.ink renderer URLs. Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI.

Quality

84%

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

82%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 well-structured, highly actionable CLI reference with executable examples covering the common cases and explicit validation guidance for agent consumers. The main gaps are minor: a small amount of redundancy (duplicated description, version section), no error-recovery feedback loop in workflows, and external documentation pointers that are not part of the skill bundle.

Suggestions

Remove the opening paragraph that duplicates the frontmatter description and drop or contextualize the 'Version: 1.0.0' section to save tokens.

Integrate validation into the example workflows (e.g. after 'export render', add 'verify output.svg exists; if render fails, parse stderr and fix diagram syntax') to create an explicit feedback loop.

Resolve the 'More Information' pointers: either include README.md/TEST.md/HARNESS.md as actual bundle reference files or remove the section, since those paths are not part of the skill.

DimensionReasoningScore

Conciseness

The body is efficient — compact command tables, executable code blocks, and no explanations of concepts Claude already knows. Minor trimmable instances remain: the opening paragraph repeats the frontmatter description verbatim, the 'Version: 1.0.0' section is time-sensitive information outside any deprecated section, and 'More Information' points to README.md/TEST.md/HARNESS.md that are not part of the skill bundle.

4 / 5

Actionability

Fully executable, copy-paste-ready commands with concrete flags and output paths throughout (e.g. 'cli-anything-mermaid project new --sample flowchart -o flow.json' and 'export render output.svg --format svg'), and the examples cover the common cases: flowchart creation/render, sequence diagram, share URLs, and REPL usage.

5 / 5

Workflow Clarity

Multi-step workflows are clearly sequenced (create project → set source → render/share) and the 'For AI Agents' section provides explicit validation checkpoints ('Check return codes', 'Parse stderr for error messages on failure', 'Verify outputs exist after render operations'). It falls short of anchor 5 because there is no explicit validate→fix→retry feedback loop integrated into the workflow steps themselves.

4 / 5

Progressive Disclosure

Good structure with clear section headers, well-organized command-group tables, and a 'More Information' section signaling further documentation. It is not anchor 5 because no bundle files exist, the referenced README.md/TEST.md/HARNESS.md live outside the skill directory and cannot be loaded, and a ~183-line single file could split command detail into references.

4 / 5

Total

17

/

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 description with concrete actions, a clear niche, and good natural trigger terms. Its main weakness is that the 'when to use' guidance is framed as audience description ('Designed for AI agents and power users who need...') rather than an explicit 'Use when...' trigger clause, and a few diagram-type synonyms are absent.

Suggestions

Add an explicit trigger clause, e.g. 'Use when the user asks for Mermaid diagrams, flowcharts, or sequence diagrams, or wants to render or share .mmd diagram source.'

Include more natural synonyms users say — ER diagrams, gantt charts, class diagrams, and the .mmd file extension — to broaden trigger coverage.

Mention the shareable Mermaid Live Editor URL generation as a concrete capability to round out action coverage.

DimensionReasoningScore

Specificity

The description lists three concrete actions ('Create, edit, and render Mermaid diagrams') with a specific mechanism ('stateful project files and mermaid.ink renderer URLs') and diagram types (flowcharts, sequence diagrams). It falls short of anchor 5 only because capabilities like share URLs, undo/redo, and JSON output mode are omitted — minor gaps in coverage.

4 / 5

Completeness

The 'what' is explicit (create/edit/render via project files and renderer URLs), and a 'when' is present through 'Designed for AI agents and power users who need to generate flowcharts, sequence diagrams, and other visualizations without a GUI' — explicit trigger guidance, though phrased as audience targeting rather than a direct 'Use when...' clause. Not anchor 3 because the 'when' is more than weakly implied; not anchor 5 because it lacks direct trigger phrasing.

4 / 5

Trigger Term Quality

It includes natural user phrases such as 'Mermaid', 'flowcharts', 'sequence diagrams', and 'render' alongside the domain-specific 'Mermaid Live Editor'. Common synonyms and extensions (ER diagram, gantt, class diagram, .mmd) are missing, placing it at anchor 4 rather than comprehensive anchor 5.

4 / 5

Distinctiveness Conflict Risk

'Command-line interface for Mermaid Live Editor' with 'mermaid.ink renderer URLs' carves out a clear niche with distinct triggers (Mermaid, flowcharts, sequence diagrams) and virtually no overlap risk with other skills.

5 / 5

Total

17

/

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

HKUDS/CLI-Anything

Path

mermaid/agent-harness/cli_anything/mermaid/skills/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.