excalidraw-diagram-generator

Generate Excalidraw diagrams from natural language descriptions. Use when asked to "create a diagram", "make a flowchart", "visualize a process", "draw a system architecture", "create a mind map", or "generate an Excalidraw file". Supports flowcharts, relationship diagrams, mind maps, and system architecture diagrams. Outputs .excalidraw JSON files that can be opened directly in Excalidraw.

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./app/skills/excalidraw-diagram-generator/SKILL.md

Quality

Content

56%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 content is highly actionable with a clear workflow and validation checklist, but it is significantly padded and inlines large sections that belong in separate reference files; one set of referenced template files is missing from the bundle.

Suggestions

Move the 'Icon Libraries (Optional Enhancement)' section (~280 lines) and the 'Not Recommended' manual integration steps into a separate references/icon-libraries.md file, keeping only the script-based workflow summary in SKILL.md.

Remove the duplicated 'Request'/'Recommended Workflow' blocks (lines 508–513) and trim emoji benefit/checkmark lists to reduce token cost without losing information.

Either create the referenced templates/flowchart-template.json, templates/relationship-template.json, and templates/mindmap-template.json files or remove those entries from the References list so no referenced path is broken.

Dimension	Reasoning	Score
Conciseness	The ~610-line body is noticeably verbose: a ~280-line 'Icon Libraries' section inlines a manual-integration approach the skill itself marks 'Not Recommended', duplicated 'Request'/'Recommended Workflow' blocks, emoji benefits lists, and explanations of concepts Claude already knows (what a flowchart or ER diagram is).	2 / 5
Actionability	Provides concrete executable commands (add-icon-to-diagram.py, add-arrow.py with full args), a complete .excalidraw JSON skeleton, layout coordinates, and worked examples, but the central Step 4 generation step lacks a full copy-paste-ready element example.	4 / 5
Workflow Clarity	A clear 6-step sequence is present with an explicit pre-delivery Validation Checklist, but error-recovery feedback loops (validate → fix → retry) are limited, placing it just below the anchor that requires explicit feedback loops.	4 / 5
Progressive Disclosure	References to real bundle files exist (references/.md, scripts/.py) and are mostly signaled, but the References list also points to templates/*.json files that do not exist in the bundle, and the bulk icon-library content that belongs in a separate reference file is inlined in SKILL.md.	3 / 5
	Total	13 / 20 Passed

Description

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

The description is specific, trigger-rich, complete, and distinctive — it cleanly answers what the skill does and when to invoke it with natural user phrases and the .excalidraw extension.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions ('Generate Excalidraw diagrams from natural language descriptions', 'Outputs .excalidraw JSON files that can be opened directly') with comprehensive coverage across diagram types and output format.	5 / 5
Completeness	Explicitly answers both what ('Generate Excalidraw diagrams… Outputs .excalidraw JSON files') and when ('Use when asked to…') with concrete trigger phrases in an explicit 'Use when' clause.	5 / 5
Trigger Term Quality	Includes natural user phrases ('create a diagram', 'make a flowchart', 'visualize a process', 'draw a system architecture', 'create a mind map', 'generate an Excalidraw file') plus the '.excalidraw' extension and 'Excalidraw file' synonym.	5 / 5
Distinctiveness Conflict Risk	'Excalidraw diagrams' is a clear niche with distinct Excalidraw-specific triggers and file format, giving minimal conflict risk with other skills.	5 / 5
	Total	20 / 20 Passed

Validation

93%

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

Validation for skill structure

Criteria	Description	Result
skill_md_line_count	SKILL.md is long (614 lines); consider splitting into references/ and linking	Warning

	Total	15 / 16 Passed

Repository: ZHangZHengEric/Sage
Path: app/skills/excalidraw-diagram-generator/SKILL.md
Commit: f93356b

Reviewed: 1 day 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.