CtrlK
BlogDocsLog inGet started
Tessl Logo

markdown-viewer

Create rich diagrams, data visualizations, technical architecture views, and editorial content cards directly in Markdown using the Markdown Viewer Agent Skills pack. Use for Mermaid-like diagram requests, PlantUML architecture diagrams, Vega charts, JSON Canvas maps, infographics, UML, cloud/network/security/data/IoT diagrams, and polished Markdown documentation visuals.

64

Quality

77%

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 ./packages/skills/markdown-viewer/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

71%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-organized router-style body with a genuinely useful renderer selection table, concrete code-fence rules, and an explicit syntax-validation step. Its main weaknesses are the unresolved upstream references (no paths, and no such files in the bundle), no example artifact to anchor output format, and minor redundancy between Workflow and Delivery.

Suggestions

Name the upstream skill files explicitly (e.g., "read `markdown-viewer/skills/uml/SKILL.md`") or link their actual paths so step 3 is resolvable without guessing.

Include one minimal example artifact per renderer family (a small plantuml block and a vega-lite block) so the output format is anchored even when the pack is not installed locally.

Add an error-recovery branch to the workflow (what to do when the syntax check fails) and trim the redundant Delivery list, which restates the Workflow's final steps.

DimensionReasoningScore

Conciseness

The body is efficient — a selection table, terse output rules, and a 6-step workflow with no explanation of concepts Claude already knows. Not 5 because a few lines justify rather than instruct ("The value of this skill is that the output stays editable, reviewable, and renderable from Markdown", "Prefer a clear, accurate first version over decorative complexity") and the Delivery section partially restates the Workflow.

4 / 5

Actionability

Mostly executable guidance: a concrete install command (`npx skills add markdown-viewer/skills`), an explicit goal→renderer mapping table, and an exact code-fence-to-renderer mapping. Not 5 because the core instruction — read the upstream skill for syntax — never shows even one example artifact block, and the upstream skill paths are never named, so a fresh agent can't execute step 3 without external installation; well above the 3 anchor's pseudocode-level guidance.

4 / 5

Workflow Clarity

A clear 6-step sequence with a validation checkpoint: "Check syntax before delivery: matching fences, valid JSON/YAML where required, PlantUML starts and ends correctly, and labels are readable". Not 5 because there is no error-recovery loop (what to do when the check fails) and the delivery reporting list is a checklist without verification; not 3 because the checkpoint is explicit and concrete, unlike the 3 anchor's merely-implied validation.

4 / 5

Progressive Disclosure

Sections are well-organized, but the body's key reference — "read the corresponding upstream `SKILL.md` for exact syntax and pitfalls" — points at files that do not exist in this bundle (no references/, scripts/, or assets/ directories) and gives no paths or links, so navigation to the detailed material is not actionable. This matches the 3 anchor ("references present but not clearly signaled") and is below 4, where references would be mostly clear and resolvable.

3 / 5

Total

15

/

20

Passed

Description

83%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: it states concrete capabilities in third person, names specific renderers, and provides an explicit "Use for..." clause with abundant concrete trigger phrases. Minor room to improve by trimming puff words ("rich", "polished"), saying "Mermaid" directly, and adding a few missing synonyms (flowchart, mind map, timeline) or file extensions.

DimensionReasoningScore

Specificity

Quotes several concrete actions — "Create rich diagrams, data visualizations, technical architecture views, and editorial content cards directly in Markdown" — plus named renderers (PlantUML, Vega, JSON Canvas). Not 5 because "rich" and "polished" introduce mild puffery and the action list stops short of full coverage (e.g., no mind map or timeline creation verbs); not 3 because well more than 1-2 concrete actions are named.

4 / 5

Completeness

Explicitly answers both questions: the "what" ("Create rich diagrams, data visualizations, technical architecture views, and editorial content cards directly in Markdown") and the "when" ("Use for Mermaid-like diagram requests, PlantUML architecture diagrams, Vega charts, JSON Canvas maps, infographics, UML, cloud/network/security/data/IoT diagrams, and polished Markdown documentation visuals") with concrete trigger phrases, matching the 5 anchor.

5 / 5

Trigger Term Quality

Good natural-term coverage: "diagram requests", "architecture diagrams", "charts", "infographics", "UML", "cloud/network/security/data/IoT diagrams" — phrases users would actually say. Not 5 because it misses common synonyms and extensions users plausibly say ("flowchart", "mind map", "timeline", "roadmap", ".puml", ".md") and "Mermaid-like" is a roundabout way to say "Mermaid".

4 / 5

Distinctiveness Conflict Risk

The niche — Markdown-native diagram/visualization rendering via a specific skill pack with named renderers — is distinct, and renderer-specific triggers (Vega, PlantUML, JSON Canvas) disambiguate well. Not 5 because generic triggers like "data visualizations" and "documentation visuals" overlap with general charting/dataviz skills; clearly above the 3 anchor's "could still overlap with similar skills" given how many renderer-specific triggers are present.

4 / 5

Total

17

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

13

/

16

Passed

Repository
EKKOLearnAI/hermes-studio
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.