excalidraw-diagram

Generate Excalidraw diagrams from text content. Supports three output modes - Obsidian (.md), Standard (.excalidraw), and Animated (.excalidraw with animation order). Triggers on "Excalidraw", "diagram", "standard excalidraw", "animate".

Quality

75%

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 ./.claude/skills/excalidraw-diagram/SKILL.md

Quality

Content

65%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

Highly actionable and concrete, with excellent spec tables and templates, but hampered by duplicated JSON/markdown blocks and a monolithic structure that under-uses the available reference file. Workflow sequencing is clear but lacks an explicit validation checkpoint.

Suggestions

De-duplicate the element JSON template and the Obsidian markdown scaffold — each is stated twice; keep one canonical copy and reference it.

Move the full element schema and color-palette detail into references/excalidraw-schema.md, leaving SKILL.md as a tighter overview that links out.

Add an explicit validation checkpoint to the workflow (e.g., parse the generated JSON to confirm validity before writing the file) with a fix-and-retry loop.

Dimension	Reasoning	Score
Conciseness	The body is mostly efficient domain spec (color tables, font rules, centering formula) but repeats material verbatim — the Obsidian markdown scaffold and element/template JSON each appear twice (Output Formats + Implementation Notes; Element Template + Required Fields) — so it could be meaningfully tightened.	2 / 3
Actionability	Provides fully concrete, copy-paste-ready guidance: complete element JSON templates, exact field lists with "do NOT add" warnings, hex color tables, font-size minimums, a centering formula with a worked example, filename formats, and example user messages.	3 / 3
Workflow Clarity	Steps are clearly sequenced (Workflow 1-7 and Implementation Notes 1-6) but there is no explicit validation checkpoint or feedback loop — step 5 only says JSON "must be valid and pass syntax checking" without an actual verify-before-save step or error-recovery path.	2 / 3
Progressive Disclosure	The single reference references/excalidraw-schema.md is real and clearly signaled with one-level-deep links, but the 468-line SKILL.md is monolithic and keeps full element templates and the color/schema detail inline rather than delegating them to the existing reference.	2 / 3
	Total	9 / 12 Passed

Description

85%

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 states a concrete action, enumerates three output formats, and gives explicit trigger guidance. Its main gap is a trigger-term list that under-covers natural variations the skill body itself relies on.

Suggestions

Add the natural trigger variations the body already uses ("flowchart", "mind map", "animated diagram") to the Triggers-on list so users can reach the skill with their actual phrasing.

Replace the slightly technical "standard excalidraw" / "animate" triggers with user-natural phrasing like "excalidraw.com diagram" / "animated diagram".

Dimension	Reasoning	Score
Specificity	Lists concrete actions — "Generate Excalidraw diagrams from text content" plus three named output modes with their file formats (.md, .excalidraw, animated), matching the multiple-specific-actions anchor.	3 / 3
Completeness	Explicitly answers what (generate diagrams in three modes) and when via the explicit "Triggers on ..." clause, which is equivalent trigger guidance to a "Use when..." clause, so it is not capped at 2.	3 / 3
Trigger Term Quality	Includes relevant natural terms ("Excalidraw", "diagram") but omits common variations the body itself uses ("flowchart", "mind map", "animated"), and "standard excalidraw"/"animate" read as slightly technical rather than what a user naturally says.	2 / 3
Distinctiveness Conflict Risk	Excalidraw is a clear, narrow niche with distinct format-specific triggers, making collision with other skills unlikely despite the generic word "diagram".	3 / 3
	Total	11 / 12 Passed

Validation

100%

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

Validation for skill structure

No warnings or errors.

Repository: breferrari/obsidian-mind
Path: .claude/skills/excalidraw-diagram/SKILL.md
Commit: aa16349

Reviewed: about 16 hours 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.