excalidraw

Create Excalidraw diagrams programmatically. Use when the user wants architecture diagrams, flowcharts, or any visual diagram with a hand-drawn aesthetic, where editable output and drag-and-drop editing add value over Mermaid's text-only approach.

Quality

82%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Failed to scan

The risk profile of this skill

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.

The body is a strong, code-dense API reference with executable examples and clear navigation that points to the bundled scripts. Its main weaknesses are mild: repeated boilerplate across examples and the absence of an explicit post-generation verification step.

Suggestions

Factor the repeated sys.path.insert boilerplate into a single snippet and reference it, or note it once and omit it from later examples, to tighten conciseness.

Add an explicit verification step after generation (e.g., open/parse the .excalidraw JSON or confirm the file exists) to strengthen workflow clarity.

Consider moving the full method-by-method API reference into a separate REFERENCE.md and keeping SKILL.md as an overview with a one-level-deep pointer, to improve progressive disclosure.

Dimension	Reasoning	Score
Conciseness	The body is code-first and avoids explaining concepts Claude already knows, but the sys.path-insert boilerplate is repeated verbatim across Quick Start and all three Complete Examples, which is minor padding that could be factored out.	4 / 5
Actionability	It provides fully executable, copy-paste-ready Python for the common cases (simple flow, decision flowchart, microservices architecture) plus concrete export commands, matching the top anchor.	5 / 5
Workflow Clarity	Quick Start gives two clear methods and Exporting to PNG is sequenced with setup steps, but there is no explicit verification checkpoint (e.g., confirming the .excalidraw file is valid or the PNG rendered), leaving a minor validation gap.	4 / 5
Progressive Disclosure	Content is well-sectioned (Quick Start, API Reference, Configuration, Examples, Viewing, Exporting, Tips) and references the real scripts/ bundle (e.g. scripts/export_playwright.js), though the bulk of the API reference is inlined rather than split into a separate reference file.	4 / 5
	Total	17 / 20 Passed

Description

82%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 well-constructed: it pairs a concrete capability statement with an explicit, trigger-rich "Use when" clause and explicitly differentiates itself from Mermaid. Its only mild weakness is specificity, since it names a single overarching action rather than enumerating several concrete operations.

Dimension	Reasoning	Score
Specificity	"Create Excalidraw diagrams programmatically" names the domain and one concrete action, but offers no broader set of capabilities, matching the anchor for 1-2 concrete actions without comprehensive coverage.	3 / 5
Completeness	It explicitly states what it does ("Create Excalidraw diagrams programmatically") and when to use it ("Use when the user wants architecture diagrams, flowcharts...") with concrete trigger phrases, matching the top anchor.	5 / 5
Trigger Term Quality	Natural user-facing terms like "architecture diagrams", "flowcharts", "visual diagram", and "hand-drawn aesthetic" give good keyword coverage, though a few synonymous phrasings users might say are absent.	4 / 5
Distinctiveness Conflict Risk	It carves a clear niche by contrasting editable Excalidraw output against "Mermaid's text-only approach", giving distinct triggers with minimal conflict risk.	5 / 5
	Total	17 / 20 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: tslateman/duet
Path: skills/excalidraw/SKILL.md
Commit: 5647baf

Reviewed: 3 days 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.